How to Use the Linux tldr Command for Quick Command Examples

The traditional way to learn about a command in Linux is to read its manual page using the man command (e.g., man tar). While manual pages are incredibly comprehensive and authoritative, they are often dense, heavily technical, and difficult to parse when you just need a quick reminder of how to perform a common task.

This is where the tldr command comes in. Standing for “Too Long; Didn’t Read,” tldr is a community-driven project that provides simplified, practical, and example-based documentation for command-line tools. It skips the exhaustive technical specifications and goes straight to showing you the most common ways a command is actually used in the real world.

Installing the tldr Command

Unlike man, the tldr client is not installed by default on most Linux distributions, but it is available in almost all default package repositories.

On Ubuntu, Debian, or Linux Mint:

sudo apt update && sudo apt install tldr

On Fedora, RHEL, or AlmaLinux:

sudo dnf install tldr

Because the tldr pages are constantly updated by the community, you must update the local cache before using it for the first time:

tldr --update

Using the tldr Command

Using tldr is exactly like using man. Simply type tldr followed by the name of the command you want to learn about.

For example, if you forget the exact flags needed to extract a .tar.gz archive, querying the manual page requires scrolling through hundreds of lines of text. Querying tldr gives you an instant, practical answer:

tldr tar

The output will typically look like this:

  tar
  Archiving utility.
  Often combined with a compression method, such as gzip or bzip2.
  More information: https://www.gnu.org/software/tar.

  - Create a compressed archive from a directory:
    tar czf target.tar.gz path/to/directory

  - Extract a compressed archive to the current directory:
    tar xzf source.tar.gz

  - Extract a compressed archive to a specific directory:
    tar xzf source.tar.gz -C path/to/directory

  - List the contents of a tar file:
    tar tvf source.tar

The output is colour-coded (in supported terminals), succinct, and immediately actionable. It provides the exact command syntax you need to copy and paste for the most frequent use cases.

When to Use tldr vs. man

The tldr command is not a complete replacement for the man command. They serve different purposes in a Linux workflow.

• Use tldr when: You already know what a command does, but you have forgotten the specific flags or syntax for a routine task (e.g., “How do I make curl follow redirects?” or “How do I find processes listening on a port with lsof?”).
• Use man when: You are learning a command for the first time, writing a robust shell script that requires obscure flags, troubleshooting unexpected behaviour, or dealing with highly complex tools (like iptables or rsync) where misunderstanding the tool’s behaviour could cause data loss or security issues.

By keeping tldr alongside man in your Linux toolkit, you get the best of both worlds: instant, practical examples for everyday tasks, backed up by exhaustive technical documentation when you need to dig deeper.