Markdown es la forma más sencilla de escribir texto con formato que sigue siendo legible como texto plano. Lo usan los archivos README, la documentación, las notas, los mensajes de chat y los sitios estáticos. Esta chuleta recoge la sintaxis que de verdad vas a usar, con especial atención a GitHub-Flavored Markdown (GFM), el dialecto que admiten GitHub, GitLab, la mayoría de las herramientas de documentación y Markdown Preview Editor.
Puedes pegar cualquiera de los ejemplos de abajo en el editor online para ver el resultado al lado.
Encabezados
Empieza una línea con entre uno y seis caracteres # seguidos de un espacio. Un # es el título de la página, ## una sección y ### una subsección.
markdown# Título de la página
## Sección
### Subsección
#### Encabezado más pequeño
Usa un solo encabezado # por documento y no te saltes niveles (por ejemplo, de ## directamente a ####). Los lectores de pantalla y los buscadores usan la estructura de encabezados para entender la página, y la mayoría de los visores generan un índice a partir de ella.
Párrafos y saltos de línea
Un párrafo es una o varias líneas de texto separadas por una línea en blanco. Un salto de línea simple dentro de un párrafo se ignora: las líneas se unen. Para forzar un salto de línea, termina la línea con dos espacios o con una barra invertida:
markdownPrimera línea con dos espacios al final
Segunda línea en el mismo párrafo.
Tras una línea en blanco empieza un párrafo nuevo.
Énfasis
| Escribes | Obtienes |
|---|---|
*cursiva* o _cursiva_ |
cursiva |
**negrita** o __negrita__ |
negrita |
***negrita cursiva*** |
negrita cursiva |
~~tachado~~ |
|
`código en línea` |
código en línea |
Muchos editores, incluido Markdown Preview Editor, admiten además algunas extensiones populares: ==resaltado==, H~2~O para subíndice, x^2^ para superíndice y códigos cortos de emoji del tipo :smile:. No forman parte de GFM, así que comprueba la plataforma de destino antes de confiar en ellas.
Listas
Usa -, * o + para listas con viñetas y números para listas ordenadas. Sangra con dos a cuatro espacios para anidar elementos.
markdown- Leche
- Pan
- Integral
- De centeno
- Café
1. Clona el repositorio
2. Instala las dependencias
3. Ejecuta la compilación
Las listas ordenadas no necesitan los números correctos: 1. en todas las líneas se sigue mostrando como 1, 2, 3. Si empiezas con otro número (por ejemplo, 5.), la lista empieza ahí.
Listas de tareas
Las listas de tareas son una extensión de GFM que convierte los elementos de una lista en casillas. Son perfectas para README, planes de lanzamiento y actas de reuniones.
markdown- [x] Escribir el borrador
- [x] Añadir capturas de pantalla
- [ ] Publicar el artículo
Enlaces
markdown[Texto del enlace](https://example.com)
[Enlace con título](https://example.com "Se muestra al pasar el ratón")
<https://example.com>
Lee la [guía de instalación][install].
[install]: https://example.com/docs/install
La última forma es un enlace de referencia: la URL se define una sola vez al final del documento, lo que mantiene legibles los párrafos largos. Los enlaces relativos como [Configuración](docs/setup.md) apuntan a otros archivos del mismo proyecto; en Markdown Preview Editor cambian a ese documento si está abierto en otra pestaña.
Imágenes
Las imágenes usan la sintaxis de los enlaces con un signo de exclamación delante. El texto entre corchetes es el texto alternativo: describe la imagen para quien no puede verla.
markdown
Cuando previsualices un documento que hace referencia a imágenes locales, abre la carpeta completa o suelta las imágenes junto con el archivo .md para que el visor pueda resolver las rutas relativas.
Código
El código en línea usa comillas invertidas simples. Para bloques, rodea el código con tres comillas invertidas y añade el nombre del lenguaje para el resaltado de sintaxis:
markdown```js
function greet(name) {
return `Hello, ${name}!`;
}
```
Nombres de lenguaje habituales: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Si tu código contiene a su vez tres comillas invertidas, delimítalo con cuatro, como en el ejemplo anterior.
Tablas
Separa las columnas con barras verticales y pon una línea de guiones bajo la cabecera. Los dos puntos de la línea separadora fijan la alineación.
markdown| Función | Gratis | Notas |
|:-------------|:------:|-------------------------------:|
| Vista previa | ✅ | Se actualiza mientras escribes |
| Exportación | ✅ | HTML, PDF, .md |
:--- alinea a la izquierda, :---: centra y ---: alinea a la derecha. No hace falta que las columnas queden alineadas en el código, aunque un buen editor las mantiene legibles. Markdown Preview Editor tiene un botón de tabla en la barra de herramientas que inserta una plantilla lista para usar.
Citas y avisos
Antepón > a las líneas para citar texto. GitHub admite además avisos (alerts): citas con una primera línea especial que se muestran como recuadros de color:
markdown> Una cita normal.
> [!NOTE]
> Información útil que conviene conocer.
> [!TIP]
> Un consejo para hacer las cosas mejor.
> [!WARNING]
> Información urgente que requiere atención inmediata.
Los cinco tipos de aviso son NOTE, TIP, IMPORTANT, WARNING y CAUTION. Úsalos con moderación: un aviso por sección destaca; cinco seguidos se convierten en ruido.
Notas al pie
Las notas al pie sacan los comentarios secundarios del texto principal. La nota puede definirse en cualquier parte y se muestra al final del documento.
markdownMarkdown se creó en 2004.[^1]
[^1]: Por John Gruber, con la ayuda de Aaron Swartz.
Líneas horizontales y caracteres de escape
Tres o más guiones, asteriscos o guiones bajos en una línea propia crean una línea horizontal: ---. Deja una línea en blanco antes; de lo contrario, --- bajo una línea de texto convierte ese texto en un encabezado.
Para mostrar un carácter que Markdown interpretaría, escápalo con una barra invertida: \*sin cursiva\*, \# no es un encabezado, \$5 (útil cuando las fórmulas están activadas).
Fórmulas y diagramas
Dos extensiones se han convertido en estándar en la escritura técnica:
- Fórmulas:
$E = mc^2$para fórmulas en línea y$$ … $$para ecuaciones destacadas. Consulta la guía completa sobre cómo escribir fórmulas matemáticas en Markdown. - Diagramas: un bloque delimitado con el lenguaje
mermaiddibuja diagramas de flujo, de secuencia, de Gantt y más. Consulta Diagramas Mermaid en Markdown.
Front matter
Los generadores de sitios estáticos leen los metadatos de un bloque YAML situado al principio del archivo:
yaml---
title: Mi artículo
date: 2026-09-27
tags: [markdown, docs]
---
Un buen visor oculta este bloque en lugar de mostrarlo como texto. Markdown Preview Editor hace exactamente eso.
Y ahora, ¿qué?
Conocer la sintaxis es la mitad del trabajo; la otra mitad es ver el resultado mientras escribes. Lee cómo previsualizar Markdown online sin subir tus archivos y, cuando tu documento esté listo, aprende a convertir Markdown a HTML o PDF.
Preguntas frecuentes
¿Qué diferencia hay entre Markdown y GitHub-Flavored Markdown?
El Markdown original (2004) definía lo básico: encabezados, énfasis, listas, enlaces, imágenes, código y citas. GitHub-Flavored Markdown es una especificación estricta basada en CommonMark que añade tablas, listas de tareas, tachado, enlaces automáticos y notas al pie. La mayoría de las herramientas modernas siguen GFM.
¿Cómo hago un salto de línea en Markdown sin crear un párrafo nuevo?
Termina la línea con dos espacios o con una barra invertida (\). Un salto de línea normal dentro de un párrafo se trata como un espacio.
¿Cómo añado un índice en Markdown?
Markdown no tiene una sintaxis propia para el índice. Puedes escribirlo a mano con enlaces a los anclajes de los encabezados, como [Tablas](#tablas). Muchas herramientas generan los anclajes automáticamente a partir de los encabezados, y Markdown Preview Editor tiene un botón Índice en la barra del editor avanzado que crea la lista por ti.
¿Puedo usar HTML dentro de Markdown?
Muchos renderizadores permiten un subconjunto de HTML, pero las plataformas eliminan todo lo que pueda ser inseguro, como scripts y manejadores de eventos en línea. Para documentos portables, prefiere la sintaxis de Markdown siempre que pueda expresar lo que necesitas.