Markdown es un formato de texto plano que se convierte en HTML con formato. Escribes títulos, listas y enlaces con unos pocos caracteres sencillos y un renderizador hace el resto. Fue diseñado para ser legible incluso antes de convertirse, y por eso se volvió el formato de escritura habitual de los archivos README, los sitios de documentación, los foros de desarrolladores, los blogs estáticos y muchas apps de notas.
Esta hoja de referencia cubre la sintaxis que usarás todos los días. Puedes pegar cualquier ejemplo en el previsualizador de Markdown y ver cómo se renderiza.
Títulos
Usa de uno a seis símbolos de numeral al inicio de la línea. Más numerales significan un título más pequeño.
# Título nivel 1
## Título nivel 2
### Título nivel 3
Deja un espacio después de los numerales y una línea en blanco antes y después del título. Usa un solo título de nivel uno por página y baja después sin saltarte niveles, lo que es mejor para los lectores y para los buscadores.
Énfasis
*cursiva* o _cursiva_
**negrita** o __negrita__
***negrita y cursiva***
~~tachado~~
El tachado forma parte de Markdown estilo GitHub y lo admiten la mayoría de los renderizadores modernos.
Párrafos y saltos de línea
Una línea en blanco separa los párrafos. Un salto de línea simple dentro de un párrafo normalmente se ignora y se une con la línea anterior. Para forzar un salto, termina la línea con dos espacios o con una barra invertida.
Listas
Las listas sin orden usan un guion, un signo más o un asterisco. Las listas ordenadas usan números seguidos de un punto. Sangra con dos a cuatro espacios para anidar elementos.
- Manzanas
- Naranjas
- Navel
- Sanguina
1. Primero
2. Segundo
3. Tercero
Los números de una lista ordenada no tienen que ser exactos. Un renderizador renumerará 1, 1, 1 como 1, 2, 3, lo que facilita reordenar.
Enlaces e imágenes
[Texto del enlace](https://example.com)
[Enlace con título](https://example.com "Texto de ayuda")
Una imagen es simplemente un enlace con un signo de exclamación delante. Escribe siempre un texto alternativo con sentido: lo leen los lectores de pantalla y se muestra si la imagen no carga.
Citas
Empieza cada línea con un signo mayor que.
> Una frase citada.
> Puede ocupar varias líneas.
Código
Envuelve el código corto entre comillas invertidas simples, como npm install. Para código de varias líneas, enciérralo entre tres comillas invertidas y añade el nombre del lenguaje después de la apertura para que el renderizador pueda resaltarlo.
```js
const total = items.reduce((a, b) => a + b, 0);
```
Líneas horizontales
Tres o más guiones, asteriscos o guiones bajos en una línea propia crean un separador: ---.
Tablas
Las tablas son una extensión que admite Markdown estilo GitHub. Separa las columnas con barras verticales y añade una fila de guiones bajo el encabezado. Los dos puntos en esa fila controlan la alineación.
| Nombre | Puesto | Edad |
| :----- | :-------: | ---: |
| Ana | Diseñadora| 31 |
| Luis | Ingeniero | 28 |
Escapar caracteres especiales
Si quieres un asterisco o numeral literal, pon una barra invertida delante: \*sin cursiva\*. Funciona con la mayoría de los signos de puntuación que Markdown trata como sintaxis.
Una palabra sobre el HTML directo
Muchos procesadores de Markdown permiten incrustar HTML para lo que Markdown no puede expresar. Ten cuidado al renderizar Markdown escrito por otras personas: el HTML sin filtrar es una forma clásica de inyectar scripts, así que sanitízalo o desactívalo.
La práctica lo vuelve automático
La sintaxis es lo bastante pequeña para aprenderla en una tarde. Ten esta página a mano, escribe algo corto y revisa la vista previa sobre la marcha. Tras una semana de uso, casi todo será memoria muscular.