Markdown: Escribe Una Vez, Publica en Cualquier Lugar
La forma más simple de formatear texto que funciona en GitHub, Notion, blogs y casi en todos lados.
Necesitas escribir documentación. O un README. O una publicación de blog. O un mensaje de Slack con formato.
HTML es excesivo. Los documentos Word no funcionan en todos lados. El texto plano no tiene formato.
Markdown está en el punto ideal. Sintaxis simple, legible como texto plano, se convierte a HTML cuando se necesita.
Lo Básico
# Encabezado 1
## Encabezado 2
### Encabezado 3
**negrita** y *cursiva*
- Punto de viñeta
- Otro punto
- Punto anidado
1. Lista numerada
2. Segundo elemento
[Texto del enlace](https://ejemplo.com)
Eso es la mayor parte de lo que necesitas.
Formato de Código
Código en línea con comillas invertidas: console.log('hola')
Bloques de código con triple comillas invertidas:
function hola() {
return 'mundo';
}
Especifica el lenguaje después de las comillas invertidas de apertura para resaltado de sintaxis.
Tablas
| Nombre | Rol |
|---------|-------------|
| Alicia | Desarrolladora |
| Roberto | Diseñador |
Las tablas son difíciles de escribir. La mayoría de editores tienen atajos.
Citas
> Esta es una cita.
> Puede abarcar múltiples líneas.
Úsalas para destacados, citas o enfatizar texto importante.
Por Qué Markdown Funciona
Fuente legible. Incluso sin renderizar, Markdown es fácil de leer. **negrita** es obviamente negrita.
Portable. GitHub, Notion, Slack, Reddit, innumerables generadores de sitios estáticos. Escribe una vez, pega en cualquier lugar.
Amigable con control de versiones. Es texto plano. Los diffs de Git tienen sentido. Los merges funcionan.
A prueba del futuro. Sin formato propietario. Tu contenido es accesible para siempre.
Diferencias de Sabores
GitHub Flavored Markdown (GFM) agrega casillas de verificación, tablas y resaltado de sintaxis.
CommonMark es el esfuerzo de estandarización. La mayoría de plataformas lo soportan.
Algunas plataformas agregan extras: Obsidian tiene wikilinks, Notion tiene bases de datos.
Para máxima portabilidad, quédate con sintaxis básica.
Errores Comunes
Olvidar líneas en blanco. Los párrafos necesitan líneas en blanco entre ellos. Sin ellas, todo se ejecuta junto.
Espacios después de encabezados. #Encabezado no funciona. # Encabezado sí. Nota el espacio.
Enlaces rotos. Omitir el https:// hace que los enlaces fallen en algunas plataformas.
Imágenes sin texto alt.  funciona pero no es accesible. Agrega descripciones.
Consejos de Escritura
Usa encabezados para estructura. Los lectores escanean antes de leer.
Mantén los párrafos cortos. El espacio en blanco ayuda a la legibilidad.
Vista previa antes de publicar. Diferentes renderizadores manejan casos extremos de manera diferente.
Markdown elimina fricción de la escritura. Aprende lo básico una vez, úsalo en todos lados. La simplicidad es la característica.