Encabezados
# H1: título de la página (uno por documento)
## H2: encabezado de sección
### H3: subsección
#### H4: rara vez hace falta
Énfasis
**negrita** o __negrita__
*cursiva* o _cursiva_
***negrita y cursiva***
~~tachado~~
Listas
- Primer elemento
- Segundo elemento
**Numeradas:** un número seguido de un punto. Los números reales dan igual, porque se renumeran solos.
``
1. Primero
2. Segundo
1. Tercero (se sigue mostrando como 3)
- [x] Tarea completada
- [ ] Tarea pendiente
- [ ] Otra tarea pendiente
Enlaces e imágenes
``` [Texto del enlace](https://example.com) [Enlace con título](https://example.com "El título aparece al pasar el ratón")  
Enlaces por referencia (muy útiles con direcciones largas): [texto del enlace][ref] [ref]: https://example.com ```
Código
Código en línea con comillas simples invertidas: const x = 1
Bloques de código delimitados, con el lenguaje indicado para el resaltado de sintaxis:
``
javascript
function greet(name) {
return Hola, ${name}!;
}
Con sangría de 4 espacios (la especificación original de Markdown; sigue funcionando, pero es mejor delimitarlos):
``
Esto es un bloque de código
Citas
> Esto es una cita.
> Puede ocupar varias líneas.
>
> Separa los párrafos con una línea en blanco.
>
> > Cita anidada
Tablas (en el Markdown de GitHub)
``` | Columna 1 | Columna 2 | Columna 3 | |-----------|-----------|-----------| | Celda | Celda | Celda | | Izquierda | Derecha | Centro |
Alineación con dos puntos: | Izquierda | Centro | Derecha | |:----------|:------:|--------:| | texto | texto | texto | ```
Líneas horizontales
Tres o más guiones, asteriscos o guiones bajos en una línea propia:
``
---
***
___
Escapar caracteres
La barra invertida escapa los caracteres especiales de Markdown:
\*, \_, \[, \], \(, \), \#, \+, \-, \., \!
Saltos de línea
Un salto de línea suelto en Markdown se muestra como un espacio. Para forzar un salto sin empezar un párrafo nuevo, termina la línea con dos espacios o más.
Para crear un párrafo nuevo, deja una línea en blanco entre los bloques.
Notas al pie (Markdown extendido)
``` Esto necesita una cita.[^1]
[^1]: El texto de la nota aparece al final. ```
Diferencias entre variantes
**CommonMark**: la especificación base. Estricta y coherente.
**Markdown de GitHub (GFM)**: añade tablas, listas de tareas, texto tachado y enlaces automáticos. Es el que se usa en los archivos README, las incidencias y las solicitudes de cambios de GitHub.
**MDX**: Markdown más componentes JSX. Se usa en los generadores de sitios estáticos basados en React.
La mayoría de los renderizadores admiten CommonMark y algunas extensiones de GFM. Si algo no se muestra como esperabas, comprueba si el renderizador admite esa extensión.
El conversor de Markdown a HTML de NoxaKit genera HTML limpio en el navegador, muy útil para ver cómo quedará tu contenido antes de publicarlo.