Hoja de referencia de Markdown: sintaxis con ejemplos
Esta referencia enumera cada elemento común de Markdown con una explicación simple de una línea y un ejemplo corto y copiable en un bloque de código.
Encabezados, párrafos y saltos de línea
Los encabezados usan de uno a seis caracteres # seguidos de un espacio; menos # significa un encabezado más grande. Una línea en blanco inicia un nuevo párrafo. Para forzar un salto de línea dentro de un párrafo, termina una línea con dos espacios o una barra invertida.
# Heading 1
### Heading 3
A paragraph.
Line break with two trailing spaces above.
Énfasis, enlaces e imágenes
Los asteriscos o guiones bajos marcan texto en cursiva y en negrita, y combinarlos da ambos efectos. Los enlaces usan corchetes para el texto y paréntesis para la URL; las imágenes usan la misma sintaxis con un ! al inicio.
*italic* **bold** ***bold italic***
[link text](https://example.com)
Listas y listas anidadas
Las listas sin orden usan -, * o +. Las listas numeradas usan números seguidos de un punto. Aplica sangría de dos o cuatro espacios para anidar una lista dentro de otra.
- item one
- item two
- nested item
1. first
2. second
Tablas
GitHub Flavored Markdown agrega tablas con barras verticales. Una fila de guiones bajo la fila de encabezado establece la estructura de columnas y puede definir la alineación.
| Name | Type |
| --- | --- |
| Alpha | text |
| Beta | number |
Código, citas y líneas horizontales
Las comillas invertidas marcan código en línea, y las triples comillas invertidas abren un bloque delimitado, opcionalmente etiquetado con un lenguaje para resaltar sintaxis. Un > al inicio de una línea marca una cita; apila varios > para anidar citas. Tres guiones, asteriscos o guiones bajos solos en una línea dibujan una línea horizontal.
Use `git status` to check the working tree.
print("hello")
> A quoted sentence.
>> A nested quote.
---
Listas de tareas y escape de caracteres
GitHub Flavored Markdown admite casillas de verificación dentro de elementos de lista. Una barra invertida antes de un carácter especial lo imprime literalmente en lugar de activar el formato. Las etiquetas HTML sin procesar también se permiten en línea en la mayoría de los renderizadores, aunque esta hoja de referencia se limita a la sintaxis Markdown simple.
- [x] done
- [ ] not done
Escaped: \* not italic \*
GitHub Flavored Markdown frente a CommonMark
CommonMark define las reglas básicas: encabezados, énfasis, listas, enlaces, bloques de código y citas. GitHub Flavored Markdown se basa en CommonMark y agrega tablas, listas de tareas, texto tachado y enlace automático de URL simples. Un archivo escrito para uno normalmente se renderiza bien en el otro, pero las tablas y las casillas de verificación necesitan soporte específico de GitHub Flavored Markdown.
Sintaxis extendida: matemáticas, notas al pie, front matter y diagramas
El soporte de estas extensiones varía según el renderizador, así que verifica la herramienta de destino antes de depender de ellas. Las matemáticas usan delimitadores de estilo LaTeX, las notas al pie usan un acento circunflejo y una etiqueta, el front matter es un bloque de metadatos al inicio del archivo, y los diagramas usan un bloque de código delimitado y etiquetado.
Inline math: $a^2 + b^2 = c^2$
Block math: $$E = mc^2$$
Text with a note.[^1]
[^1]: The note itself.
---
title: Example document
date: 2026-01-01
---
graph TD
A --> B
B --> C
Poniéndolo todo junto
Escribe y previsualiza un documento con el Editor de Markdown, verifica problemas de sintaxis con Markdown Lint, y genera una tabla de contenidos con Markdown TOC. Cuando necesites un archivo compartible, exporta con Markdown a PDF o Markdown a Word. Para profundizar en la conversión de PDF de vuelta a Markdown, consulta la guía de PDF a Markdown.