Si has visto algún README.md en GitHub, has editado una página en Notion, o has dado formato a un mensaje en Discord o Slack, ya usaste Markdown — probablemente sin saberlo. Markdown es el formato de texto plano más extendido en internet para escribir contenido con formato sin tener que tocar un solo botón.
En este artículo te explicamos qué es, por qué se volvió un estándar, cuándo te conviene usarlo y cómo aprender la sintaxis en menos tiempo del que tarda un café.
¿Qué es Markdown exactamente?
Markdown es un lenguaje de marcado ligero creado en 2004 por John Gruber y Aaron Swartz. La idea era simple: escribir texto que se vea natural mientras lo escribes, y que al renderizarlo se convierta en HTML bien formado. Nada de etiquetas verbosas, nada de menús — solo símbolos pequeños y memorables.
Por ejemplo, para hacer un encabezado escribes # Mi título. Para poner una palabra en negrita, la rodeas con asteriscos: **negrita**. Para una lista, pones un guion al inicio de cada línea. El resultado se lee bien incluso si nadie lo renderiza.
Por qué se volvió un estándar
Tres razones lo llevaron a dominar:
- Es legible en bruto. Un archivo
.mdno necesita una app para entenderse. Lo abres en el bloc de notas y todo tiene sentido. - Versionable como código. Los archivos Markdown son texto plano, así que cabe perfecto en Git. Por eso GitHub, GitLab y Bitbucket lo adoptaron desde temprano.
- Universal. Casi todas las plataformas modernas — Notion, Obsidian, Ghost, Hashnode, Discord, Reddit, Slack, Substack — soportan al menos un subconjunto de Markdown.
Cuándo te conviene usar Markdown
- Documentación técnica (READMEs, manuales internos, runbooks).
- Posts de blog (este mismo artículo está escrito en Markdown).
- Notas personales y bases de conocimiento (Obsidian, Logseq, Bear).
- Issues y PRs en plataformas de código.
- Mensajes en herramientas de equipo (Slack, Discord, Teams).
- Newsletters (Beehiiv, Ghost, Substack lo aceptan).
Cuando no te conviene: cuando necesitas control fino de tipografía, layout multicolumna, o anidación visual compleja. Ahí tienen sentido HTML/CSS o un editor visual como Notion/Coda.
Sintaxis esencial (memorízala en 5 minutos)
# Encabezado 1
## Encabezado 2
### Encabezado 3
Un párrafo normal con **negrita**, *cursiva* y ~~tachado~~.
- Lista con guion
- Otro elemento
1. Lista numerada
2. Segundo paso
[Texto del enlace](https://waloja.com)
> Esto es una cita.
`código en línea` y bloque de código:
```js
function hola() { return "mundo"; }
```
| Columna A | Columna B |
| --------- | --------- |
| Dato 1 | Dato 2 |Con eso cubres el 95% de lo que vas a escribir. El resto (notas al pie, listas de tareas, HTML embebido) es opcional y depende del intérprete que uses.
Sabores de Markdown
No hay UN solo Markdown. Hay variantes (“flavors”) que añaden funciones:
- CommonMark — la especificación estricta. Es el comportamiento base.
- GitHub Flavored Markdown (GFM) — añade tablas, tachado, checkboxes, y enlaces automáticos. Es lo que la mayoría espera hoy.
- MDX — Markdown + componentes JSX. Útil si trabajas con React/Astro.
Si solo vas a escribir contenido normal, GFM es lo que necesitas. Es lo que renderiza nuestro editor.
Pruébalo ahora
Si nunca has escrito Markdown, la mejor manera de aprenderlo es jugar con él. Construimos un editor en vivo que te muestra el resultado a la derecha mientras escribes a la izquierda:
→ Abre el Editor de Markdown de Waloja
Pega un README de algún proyecto que conozcas, edítalo y mira cómo cambia. En 15 minutos vas a tener la sintaxis lista para el resto de tu carrera.
Si tu equipo está escribiendo documentación, notas o contenido y todavía pelea con Google Docs y Word, considera mover el flujo a Markdown. Es la diferencia entre archivos que envejecen bien y archivos que terminan rotos en cinco años.