Qué es Markdown y por qué usarlo

Markdown es una forma de escribir texto con formato usando solo caracteres comunes: un numeral para un título, asteriscos para la negrita, un guion para una lista. El archivo sigue siendo texto plano, se lee bien sin ningún programa especial y funciona en herramientas de notas, en GitHub y con inteligencia artificial.

Qué es

Markdown es una manera de darle formato a un texto sin usar un procesador de textos. En lugar de apretar un botón para poner algo en negrita, escribís **así**. En lugar de elegir "Título 1" en un menú, empezás la línea con #. El resultado es un archivo de texto común, con extensión .md, que se puede leer tal cual o mostrarse con formato en cualquier programa compatible.

La idea es que el texto se entienda aunque nadie lo "dibuje": una lista de Markdown se ve como una lista incluso en el Bloc de notas.

De dónde viene

Markdown lo creó John Gruber en 2004, con aportes de Aaron Swartz. En ese momento, para publicar en la web había que escribir en HTML, con etiquetas como <strong> o <ul> que hacían el texto difícil de leer y de escribir. Gruber propuso usar las convenciones que la gente ya usaba en los correos de texto plano, como los asteriscos para enfatizar o los guiones para las listas, y traducirlas automáticamente a HTML. Podés leer la presentación original de Markdown en su sitio.

Con los años aparecieron variantes. Hoy las dos más usadas son CommonMark, que define el Markdown básico de forma precisa, y GitHub Flavored Markdown (GFM), que le agrega tablas, tachado y listas de tareas. pasaloamd genera Markdown compatible con las dos.

Por qué usarlo

No dependés de un programa

Un documento de Word necesita Word, o un programa compatible, para verse bien, y los archivos viejos pueden abrirse con el formato alterado. Un archivo .md es texto plano: se abre con cualquier editor, en cualquier sistema, y va a poder leerse dentro de muchos años. Si hoy usás Obsidian y mañana preferís otra herramienta, te llevás la carpeta con tus archivos y seguís trabajando.

Es ideal para trabajar con inteligencia artificial

Las IA como Claude, ChatGPT o Gemini entienden muy bien Markdown, y el texto limpio ocupa menos espacio que un PDF o un Word. Por ejemplo, cuando le pasás un PDF a Claude, cada página se procesa como texto y como imagen; si le pasás el mismo contenido en Markdown, recibe solo el texto, con los títulos, las listas y las tablas bien marcados. Eso significa menos tokens, y por lo tanto conversaciones más largas y menos costo. Te cuento los datos con sus fuentes en Acerca de.

Sirve para investigar y trabajar con datos

Si trabajás en ciencias sociales o con documentos que analizás, Markdown te deja tener entrevistas, notas de campo, informes y bibliografía como texto ordenado, fácil de buscar, de citar y de procesar con herramientas de análisis o con IA. Y si convertís esos documentos con pasaloamd, no hace falta subirlos a ningún servicio externo: más detalles en las preguntas frecuentes.

Permite seguir los cambios

Como es texto plano, cada cambio se puede comparar línea por línea con herramientas como Git. Por eso Markdown es el formato habitual de la documentación de software, y cada vez más gente lo usa para escribir en equipo sin terminar con archivos como "informe_final_v3_corregido.docx".

Cuándo no conviene

Markdown no reemplaza a Word para todo. Si necesitás un diseño de página muy cuidado, control preciso de márgenes o tipografías, o enviar un documento a alguien que solo usa Word, un procesador de textos sigue siendo mejor. Markdown brilla cuando lo importante es el contenido y su estructura.

Cómo se escribe

Esta es la sintaxis más usada, la que genera pasaloamd:

Elemento Cómo se escribe Cómo se ve
Título de nivel 1 # Título Título grande
Título de nivel 2 ## Sección Título mediano
Título de nivel 3 ### Subsección Título chico
Negrita **texto importante** texto importante
Cursiva *un término* un término
Tachado ~~ya no va~~ ya no va
Lista con viñetas - Primer elemento • Primer elemento
Lista numerada 1. Paso uno 1. Paso uno
Lista de tareas - [x] Hecho / - [ ] Pendiente ☑ Hecho / ☐ Pendiente
Cita > Una frase citada Una frase citada, con una línea al costado
Código en una línea `total = 42` total = 42
Enlace [pasaloamd](https://pasaloamd.com) pasaloamd

Hay tres elementos que ocupan varias líneas y no entran en la tabla. Así se escriben:

Una tabla, con barras verticales para separar las columnas y una fila de guiones debajo del encabezado:

| Producto | Precio |
| :--- | :--- |
| Cuaderno | $500 |

Y así se ve:

Producto Precio
Cuaderno $500

Un bloque de código, entre tres comillas invertidas:

```
print("hola")
```

Y así se ve:

print("hola")

Una línea divisoria, con tres guiones solos en una línea (---), que se ve así:

Dónde se usa

  • Herramientas de notas: Obsidian, Logseq, Joplin, Bear y Typora trabajan directamente con archivos Markdown.
  • Programación y documentación: los archivos README de GitHub y GitLab, y muchos generadores de sitios de documentación, como Docusaurus, Hugo o Astro.
  • Colaboración: Notion acepta Markdown al pegar y al escribir. Slack, Discord y Teams usan una versión simplificada para dar formato a los mensajes.
  • Inteligencia artificial: muchas IA escriben sus respuestas en Markdown y lo entienden muy bien como entrada.

Si querés empezar a usarlo, podés convertir un documento que ya tengas o escribir uno desde cero en el editor de Markdown.