TLDR: las man pages que siempre quisiste tener

Llevo años trabajando con Linux, y si hay algo que siempre me ha sacado de quicio son las páginas man. No me malinterpretes, son una fuente de información increíblemente completa, pero a veces lo que necesitas no es un tratado sobre el formato de cintas magnéticas de los años 70. A veces lo único que quieres es recordar cómo comprimir un directorio con tar sin tener que leer tres párrafos sobre el parámetro -b blocksize. Y claro, buscar en Google tampoco es la panacea: te encuentras con blogs que copian unos de otros, soluciones desactualizadas y, en el peor de los casos, consejos que directamente rompen tu sistema. Por eso, hace tiempo que incorporé TLDR a mi día a día, y te aseguro que no volví a mirar atrás 😊

El problema de siempre

Todos lo hemos hecho. Estás en la terminal, necesitas hacer algo con find, rsync o ffmpeg, y en lugar de recurrir a la documentación oficial, abres el navegador y tecleas cómo hacer x con y. El resultado es casi siempre el mismo: una docena de páginas que repiten lo mismo, muchas de ellas sin actualizar desde 2014, y ninguna que te dé exactamente lo que buscas.

El problema es doble. Por un lado, la desactualización. El software evoluciona, las opciones cambian, y lo que funcionaba en Ubuntu 16.04 puede que en 2026 directamente no compile. Las páginas que encuentras en Google están llenas de contenido obsoleto, y si no tienes cuidado, acabas ejecutando comandos que ya no funcionan o, peor aún, que han sido reemplazados por alternativas más seguras.

Por otro lado, la falta de contexto. La mayoría de esos sitios se limitan a copiar ejemplos de otros sitios sin verificar si funcionan. He visto tutoriales que sugerían ifconfig para configurar la red, cuando ifconfig lleva años obsoleto en favor de ip. Y cuando algo falla, te quedas con la duda de si el error es tuyo, del tutorial o de que el comando ha cambiado entre versiones.

Las páginas man son la fuente oficial, eso nadie lo discute. Pero tienen un problema de enfoque. Están diseñadas para ser una referencia exhaustiva, no una guía rápida. Cuando ejecutas man tar, el primer párrafo que te encuentras habla del formato de las cintas magnéticas. ¿De verdad alguien hojea eso a día de hoy? Para un veterano es ruido, y para un novato es directamente terrorífico.

Ahí entra TLDR. El nombre lo dice todo: Too Long; Didn’t Read. Es exactamente lo que necesitas cuando no quieres leer un manual de 50 páginas, sino ver cinco ejemplos bien puestos y seguir con tu vida.

¿Qué es TLDR?

TLDR no es un programa, sino un proyecto colaborativo que mantiene una colección de cheatsheets o resúmenes para cientos de comandos. La idea es tan sencilla como brillante: en lugar de una página man con 800 líneas, TLDR te muestra los 8 casos de uso más comunes de cada herramienta, con ejemplos listos para copiar y pegar.

El proyecto vive en GitHub bajo el paraguas de tldr-pages, tiene más de 63.000 estrellas y cuenta con la colaboración de cientos de contribuyentes de todo el mundo. Las páginas están escritas en Markdown, traducidas a más de 30 idiomas, y se distribuyen bajo licencia MIT.

Métrica	Detalles
Licencia	MIT
SOs soportados	Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, SunOS, Android, Cisco IOS
Lenguaje de las páginas	Markdown
Clientes oficiales	Python, Rust (tlrc), Node.js
Repositorio	github.com/tldr-pages/tldr
Estrellas	63.000+
Páginas en inglés	+1.500
Traducciones	30+ idiomas

¿Para quién es?

Novatos que se sienten abrumados por la cantidad de opciones de un comando y necesitan ejemplos claros
Veteranos que necesitan un recordatorio rápido de una sintaxis que usan una vez al mes
Usuarios de Windows con WSL que quieren ejemplos prácticos sin tener que memorizar cada flag
Desarrolladores que saltan entre herramientas constantemente y no pueden recordar la sintaxis de todas
Cualquier persona que prefiera un ejemplo a tres párrafos de teoría

Cómo funciona por dentro

Cada página de TLDR es un archivo Markdown con una estructura muy simple. Aquí tienes un ejemplo real de la página de tar:

# tar > Archiving utility. > Often combined with a compression method, such as gzip or bzip2. > More information: <https://www.gnu.org/software/tar/manual/tar.html>. - Create an archive from files: tar cf {{target.tar}} {{file1 file2 file3}} - Create a gzipped archive: tar czf {{target.tar.gz}} {{file1 file2 file3}} - Extract a (compressed) archive into the current directory: tar xf {{source.tar}} - Extract a (compressed) archive into a target directory: tar xf {{source.tar}} -C {{directory}} - Create a compressed archive with the suffix auto-detected: tar caf {{target.tar.xz}} {{file1 file2 file3}} - List the contents of a tar file: tar tvf {{source.tar}}

Fíjate en los detalles. Cada ejemplo está numerado del caso más simple al más complejo. Los parámetros que tienes que rellenar van entre dobles llaves {{ }}, lo que deja clarísimo qué hay que cambiar. La descripción del comando va en una línea que empieza con >, y hay un enlace a la documentación oficial por si necesitas profundizar.

El proyecto mantiene una especificación de cliente que define cómo deben comportarse los clientes. Esto ha permitido que surja un ecosistema enorme: desde aplicaciones de terminal hasta extensiones para el navegador, pasando por plugins para Slack, Telegram, Emacs, Visual Studio Code y Alfred.

¿Qué lo diferencia de otras alternativas?

cheat.sh: también ofrece ejemplos, pero los agrega de múltiples fuentes. TLDR es más coherente porque todo el contenido sigue el mismo formato y las mismas convenciones.
eg: similar, pero con menos cobertura de comandos y una comunidad más pequeña.
navi: permite crear tus propios cheatsheets interactivos, pero requiere más configuración inicial y no tiene una comunidad tan activa.
bropages: un proyecto similar que permitía votar ejemplos, pero que está deprecado desde hace años.
man: la referencia completa, pero exactamente lo que queremos evitar cuando usamos TLDR. No es competencia, son complementos.

Instalación: elige tu cliente

Aquí viene lo bueno. Ya no estamos en 2018 cuando la mejor opción era tldr++, que por cierto está abandonado y no recibe actualizaciones desde 2020. Ahora mismo tienes tres clientes oficiales y una veintena de comunitarios entre los que elegir. Te cuento los más interesantes.

Cliente Python (recomendado para empezar)

Es el cliente más maduro y el que mejor soporte tiene. Se instala con pipx:

pipx install tldr

Si no tienes pipx, puedes instalarlo primero desde los repositorios de tu distribución:

sudo apt install pipx # Ubuntu, Debian, Mint sudo dnf install pipx # Fedora sudo pacman -S python-pipx # Arch Linux pipx ensurepath

Y una vez instalado, reinicia la terminal o recarga el PATH. A partir de ese momento, solo tienes que escribir:

tldr tar tldr ffmpeg tldr rsync tldr docker

La primera vez que ejecutes tldr te descargará el índice completo de páginas. A partir de ahí, las consultas son instantáneas porque las guarda en caché local.

Cliente Rust (tlrc) — el más rápido

Si eres de los que quieren la máxima velocidad, el cliente oficial escrito en Rust es tu opción. Se llama tlrc y se instala con Cargo:

cargo install tlrc --locked

O si usas Homebrew en Linux o macOS:

brew install tlrc

En Windows puedes usar Winget:

winget install tldr-pages.tlrc

Este cliente es notablemente más rápido que el de Python en la primera consulta, porque el motor de renderizado es más ligero y está compilado a código nativo. En el día a día apenas notas la diferencia si ya tienes la caché cargada, pero si eres un power user que consulta TLDR decenas de veces al día, merece la pena el cambio.

Además, tlrc tiene un modo interactivo que te permite navegar por los ejemplos con el teclado, seleccionar uno y copiarlo al portapapeles directamente. Es una experiencia de usuario muy superior.

Cliente Node.js

Hubo un tiempo en que este era el cliente oficial. Hoy está algo rezagado en actualizaciones, pero sigue funcionando perfectamente si tienes Node.js instalado:

npm install -g tldr

Otros clientes interesantes

Además de los oficiales, hay clientes para todos los gustos:

Tealdeer: otro cliente en Rust, pero más minimalista que tlrc. Es compila en segundos y tiene un ejecutable de menos de 2 MB.
tldr.jsx: un cliente web escrito en React que puedes alojar en tu propio servidor.
tldr-python-client: la versión original del cliente Python, que sigue manteniéndose.
Cliente para Emacs: disponible en MELPA como tldr.
Extensión para VSCode: busca tldr en el marketplace y tendrás las páginas directamente en el editor.
Workflow para Alfred: si usas macOS, puedes consultar TLDR desde la paleta de Alfred.

Sin instalar nada: versión web

Si solo quieres echar un vistazo sin compromiso, tienes el cliente web en tldr.inbrowser.app. Funciona como PWA, así que puedes instalarlo en el móvil o usarlo sin conexión después de la primera visita. Es perfecto para cuando estás en un equipo que no es el tuyo y no puedes instalar nada.

Otra opción muy cómoda es la versión PDF que publican en cada release. Te descargas el libro completo con todas las páginas y lo consultas sin conexión, en el lector de PDF que prefieras.

Uso práctico: ejemplos que te salvarán el día

Una vez instalado el cliente, el uso es trivial. La sintaxis es siempre la misma:

tldr <comando>

Vamos a ver algunos casos prácticos de comandos que uso a diario y para los que TLDR me ha sacado de más de un apuro.

`tar`: el clásico que nunca recuerdas

tldr tar

Y en menos de un segundo tienes esto:

tar Archiving utility. Often combined with a compression method, such as gzip or bzip2. - Create an archive from files: tar cf {{target.tar}} {{file1 file2 file3}} - Create a gzipped archive: tar czf {{target.tar.gz}} {{file1 file2 file3}} - Extract a (compressed) archive into the current directory: tar xf {{source.tar}} - Extract a (compressed) archive into a target directory: tar xf {{source.tar}} -C {{directory}} - List contents: tar tvf {{source.tar}}

¿Ves? Justo lo que necesitas, sin rodeos. Los parámetros entre {{ }} te indican exactamente qué tienes que sustituir. No hay que leer tres pantallas de documentación para encontrar el comando que buscas.

`ffmpeg`: el todoterreno del vídeo

ffmpeg es uno de esos comandos que tiene 400 opciones y que usas para tareas muy concretas: convertir un vídeo, extraer audio, recortar un segmento, cambiar de formato… Con TLDR no tienes que memorizar nada:

tldr ffmpeg

Te muestra ejemplos para: – Convertir de un formato a otro – Extraer el audio de un vídeo – Recortar un segmento temporal – Redimensionar el vídeo – Cambiar el frame rate

Cada uno con su sintaxis completa, lista para copiar y pegar cambiando los nombres de los archivos.

`find`: el buscador que nunca dominas del todo

tldr find

Te saca del apuro cuando necesitas buscar archivos por nombre, por tamaño, por fecha de modificación, o ejecutar un comando sobre los resultados. Cosas que sabes que se pueden hacer, pero cuya sintaxis se te borra de la cabeza en el momento menos oportuno.

Por ejemplo, buscar todos los archivos .log de más de 100 MB:

find . -name "*.log" -size +100M

O ejecutar un comando sobre los resultados:

find . -name "*.tmp" -exec rm {} \;

Con TLDR lo tienes todo a mano en formato de ejemplo.

`rsync`: el rey de las copias

tldr rsync

Te muestra los casos típicos: sincronización local, remota por SSH, excluir archivos, mostrar progreso, mantener permisos… Todo lo que necesitas para no cargarte una transferencia por un flag mal puesto.

`docker`: porque nadie se sabe todos los subcomandos

tldr docker

Incluso para herramientas modernas como Docker, TLDR tiene páginas. Y no solo para el comando principal, sino también para subcomandos como docker run, docker-compose, dockerfile y docker-container.

`git`: el pan de cada día

tldr git

Te muestra los comandos básicos de Git, pero también puedes consultar subcomandos específicos:

tldr git checkout tldr git rebase tldr git stash tldr git log

Buscar sin saber el comando exacto

¿No recuerdas el nombre exacto del comando? El cliente Python permite buscar por palabras clave:

tldr --search compress

Te devuelve todas las páginas relacionadas con compresión: tar, gzip, bzip2, xz, zip, 7z, etc. Es muy útil cuando sabes lo que quieres hacer pero no cómo se llama la herramienta.

Cliente interactivo con tlrc

Si instalaste el cliente de Rust (tlrc), tienes una experiencia interactiva muy superior. Puedes navegar por los ejemplos con las flechas del teclado, seleccionar uno, y ejecutarlo directamente desde el mismo cliente. Es como tener un asistente que te va guiando paso a paso, especialmente útil cuando estás aprendiendo un comando nuevo.

Trucos y detalles finos

Aquí van algunos detalles que he ido descubriendo con el uso y que marcan la diferencia 💡

Cacheo local

Los clientes de TLDR descargan las páginas y las guardan en caché local. Esto significa que la primera consulta puede tardar un par de segundos, porque descarga el índice completo con todas las páginas. Pero a partir de ahí, las consultas son instantáneas. Además, puedes usar TLDR sin conexión después de la primera descarga, lo que viene genial si trabajas en un tren o en un avión sin Internet.

Para actualizar la caché manualmente:

tldr --update

Yo tengo un cron que ejecuta esto una vez a la semana, así siempre tengo las páginas más recientes sin acordarme.

Colores y personalización

Los clientes modernos muestran las páginas con colores: los comandos en azul, los parámetros en amarillo, las descripciones en blanco. Esto hace que sea mucho más fácil escanear visualmente la página y encontrar lo que buscas de un vistazo.

Si quieres personalizar los colores, puedes usar las variables de entorno:

export TLDR_COLOR_NAME="blue" export TLDR_COLOR_DESCRIPTION="white" export TLDR_COLOR_PARAMETER="yellow"

Cada cliente soporta los colores que permite su terminal. Si usas una terminal con soporte de 256 colores o true color, el resultado es muy vistoso.

Navegador de páginas con fzf

Una de las formas más cómodas de explorar TLDR es combinarlo con fzf, el buscador difuso que ya te he recomendado en otras ocasiones. Añade este alias a tu .bashrc o .zshrc:

alias tldrview='tldr --list | fzf --preview "tldr {1} --color=always" --preview-window=right,70% | xargs tldr'

Así puedes buscar páginas con fuzzy search y previsualizarlas antes de abrirlas. Es una maravilla 🔥 y desde que lo uso no concibo otra forma de consultar TLDR.

Añadir tus propias páginas

El proyecto es abierto, así que puedes contribuir con tus propios ejemplos. Solo tienes que hacer un fork del repositorio, editar la página correspondiente en Markdown siguiendo las guías de estilo, y enviar un pull request. Las guías de contribución son muy claras y el proceso es sencillo, incluso si nunca has contribuido a un proyecto open source.

Pero si lo que quieres es tener tus propios comandos personalizados sin pasar por GitHub, puedes usar el directorio local. En Linux, los clientes suelen buscar en ~/.tldr/ además del repositorio oficial. Basta con crear tus propios archivos Markdown ahí, con la misma estructura, y el cliente los mostrará junto con los oficiales.

Integración con otras herramientas

TLDR se integra con un montón de herramientas de las que probablemente ya usas:

Emacs: hay un paquete tldr en MELPA. Lo instalas con M-x package-install tldr y ya puedes consultar páginas desde el editor.
Slack: hay un comando de Slack que te devuelve la página TLDR de cualquier comando. Ideal para compartir en canales de desarrollo.
Telegram: hay un bot que te devuelve las páginas directamente en el chat.
Alfred: workflow para macOS que te permite consultar TLDR desde la paleta de Alfred.
Visual Studio Code: extensión en el marketplace que te muestra TLDR en el panel de comandos.
Vim: plugin disponible que te permite consultar TLDR sin salir del editor.

TLDR en el mundo real

¿Y cómo uso yo TLDR en el día a día? Pues te cuento un par de escenarios reales.

Escenario 1: el despliegue de emergencia

Estás en medio de un despliegue y necesitas comprimir los logs antes de copiarlos al servidor de backup. Tienes prisa, no es momento de buscar en Google. Un tldr tar te da el comando exacto en segundos. Lo mismo para rsync si necesitas sincronizar con el servidor remoto.

Escenario 2: el script de madrugada

Son las 3 de la mañana, estás escribiendo un script y necesitas usar sed para hacer una sustitución en varias líneas. Sabes que se puede hacer, pero no recuerdas la sintaxis exacta. tldr sed te lo muestra al instante, sin tener que romperte la cabeza.

Escenario 3: el colega que pregunta

Un compañero te pregunta por Telegram cómo se hace una búsqueda con find. En lugar de escribirle la sintaxis de memoria y arriesgarte a equivocarte, le pasas la salida de tldr find. Incluso le puedes compartir el enlace a la web.

Escenario 4: aprendiendo algo nuevo

Te has propuesto aprender jq para manejar JSON en la terminal. tldr jq te muestra los casos de uso más comunes: filtrar, transformar, acceder a propiedades anidadas, formatear… Todo con ejemplos que puedes probar inmediatamente.

Pros y contras

TLDR no es perfecto, y como buena herramienta, hay que saber cuándo usarla y cuándo no.

Lo bueno 👍

Velocidad: obtienes lo que necesitas en segundos, sin navegar ni leer párrafos innecesarios
Claridad: los ejemplos son concisos y van al grano, sin florituras
Actualización constante: al ser comunitario, las páginas se mantienen al día. Si un comando cambia, alguien actualiza la página
Multiplataforma: funciona en Linux, macOS, Windows, Android, y hasta en routers Cisco
Traducciones: más de 30 idiomas, incluido el español
Ecosistema rico: clientes para todos los gustos y plataformas, desde terminal hasta web
Código abierto: licencia MIT, puedes modificarlo y redistribuirlo sin problemas
Contribución sencilla: cualquier puede añadir o modificar páginas con un simple PR

Lo malo 👎

Superficial: si necesitas entender en profundidad una herramienta, TLDR no te sirve. Ahí tienes que ir a man o a la documentación oficial
Cobertura incompleta: aunque tiene miles de páginas, no cubre todos los comandos existentes. Si usas herramientas muy nicho, puede que no encuentres página
Dependencia externa: al ser un proyecto independiente, necesitas instalar un cliente. No viene preinstalado en las distribuciones
Calidad variable: al ser contribuciones de la comunidad, algunas páginas están mejor cuidadas que otras. Pero en general el nivel es alto gracias a los procesos de revisión
Curva de contribución: aunque contribuir es sencillo, hay que seguir unas guías de estilo que pueden resultar tediosas para una contribución puntual

Conclusión

TLDR se ha convertido en una de esas herramientas que, una vez que las pruebas, no entiendes cómo has podido vivir sin ellas. No pretende sustituir a las páginas man, sino complementarlas. Es como tener a un colega experto al lado que te susurra el comando exacto cuando te quedas en blanco.

Si nunca lo has probado, te animo a que instales el cliente Python y hagas la prueba. Ejecuta tldr tar y compara con man tar. La diferencia es abismal, y en cuestión de días te preguntarás por qué no lo hiciste antes.

Y si ya lo usas, plantéate dar el salto al cliente Rust. La velocidad extra y el modo interactivo merecen la pena. Además, tlrc se actualiza con frecuencia y tiene una comunidad muy activa.

En cualquier caso, la próxima vez que te veas tentado a abrir Google para recordar cómo comprimir un fichero, acuérdate de TLDR. Te ahorrarás tiempo, frustración y algún que otro mal ejemplo copiado de internet 😊

Más información,