Hoja de referencia de Markdown: Referencia rápida de sintaxis, formato y estructura
Referencia rápida de Markdown: encabezados, listas, código, tablas y más.
El lenguaje Markdown se utiliza en Wikipedia y en Hugo. Cuenta con soporte para encabezados, listas, modificaciones de estilo de fuente, imágenes, citas de código y tablas. Aquí mantengo un breve resumen del formato de Markdown.
La imagen anterior fue producida por Flux - IA de texto a imagen.
Markdown es un lenguaje de marcado ligero que puedes usar para agregar elementos de formato a documentos de texto plano. Esta guía proporciona una visión general exhaustiva de la sintaxis de Markdown más comúnmente utilizada, ayudándote a crear documentos bien estructurados y visualmente atractivos.
Esta hoja de trucos es parte del hub de Herramientas de Documentación en 2026: Markdown, LaTeX, PDF y Flujos de Trabajo de Impresión.
Encabezados de Markdown (H1–H6)
Los encabezados en Markdown se crean utilizando el símbolo de almohadilla (#). El número de almohadillas antes del texto del encabezado indica el nivel del encabezado.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Negrita, Itálica y Énfasis
Markdown proporciona varias formas de enfatizar el texto. Puedes usar asteriscos (*) o guiones bajos (_) para itálicas y dobles asteriscos (**) o dobles guiones bajos (__) para negrita.
Itálica
*Itálica* o _itálica_
Negrita
**Negrita** o __negrita__
Negrita e Itálica
***Negrita e itálica*** o ___negrita e itálica___
Listas Ordenadas y Desordenadas
Markdown soporta tanto listas ordenadas como desordenadas.
Lista Desordenada
- Elemento 1
- Elemento 2
- Subelemento 1
- Subelemento 2
Lista Ordenada
1. Primer elemento
2. Segundo elemento
1. Subelemento 1
2. Subelemento 2
Hipervínculos en Markdown
Puedes crear enlaces envolviendo el texto del enlace entre corchetes cuadrados ([]) y luego envolviendo la URL entre paréntesis (()).
[Texto del Enlace](URL)
Ejemplo
Visita la [Guía de Markdown](https://www.markdownguide.org/) para más información.
Inserción de Imágenes
Las imágenes se agregan usando un signo de exclamación (!) seguido por el texto alternativo entre corchetes y la URL de la imagen entre paréntesis.
Ejemplo
Citas en Bloque y Citas Anidadas
Las citas en bloque se crean utilizando el símbolo mayor que (>).
> Esta es una cita en bloque.
Citas en Bloque Anidadas
> Este es el primer nivel de cita.
>> Esta es una cita en bloque anidada.
Código en Línea y Bloques de Código Delimitados
Puedes agregar código en línea envolviéndolo en comillas invertidas (`). Para bloques de código, usa triples comillas invertidas (```) antes y después del código.
Código en Línea
Usa `printf()` para imprimir texto en C.
Bloques de Código
```python
python def hello_world(): print("¡Hola, Mundo!")
```
Más sobre bloques de código en Markdown, ver publicación separada: Uso de Bloques de Código en Markdown. El identificador de lenguaje mermaid es un caso especial notable: activa el renderizado de diagramas en lugar de la resaltado de sintaxis, convirtiendo un bloque delimitado plano en un diagrama de flujo o de secuencia. La Guía Rápida de Diagramas Mermaid cubre la sintaxis completa de diagramas, desde diagramas de flujo hasta diagramas ER.
Reglas Horizontales (Separadores)
Las reglas horizontales se crean usando tres o más guiones (—), asteriscos (***) o guiones bajos (___).
---
Tablas
Las tablas en Markdown se crean usando tuberías (|) y guiones (-).
Ejemplo
| Encabezado 1 | Encabezado 2 |
|----------|----------|
| Celda 1 | Celda 2 |
| Celda 3 | Celda 4 |
Para opciones de alineación, formato de múltiples columnas y características específicas de GFM, consulta la Guía Completa de Tablas en Markdown.
Listas de Tareas (Casillas de Verificación)
Las listas de tareas son un tipo especial de lista que te permite crear casillas de verificación.
Ejemplo
- [x] Tarea completada
- [ ] Tarea incompleta
Texto Tachado
El texto tachado se crea usando dobles tilde (~~).
~~Este es texto tachado.~~
Resaltado de Texto
El resaltado de texto no es soportado nativamente en Markdown, pero algunos renderizadores lo soportan usando la sintaxis ==.
Ejemplo
==Este es texto resaltado.==
Subíndices y Superíndices
Los subíndices se crean usando un caret (^) antes del texto, y los superíndices se crean usando una tilde (~) antes del texto.
Ejemplo
H~2~O es agua.
E = mc^2
Ecuaciones Matemáticas (Sintaxis LaTeX)
Las ecuaciones matemáticas pueden agregarse usando la sintaxis LaTeX entre signos de dólar ($).
Ejemplo
$$ E = mc^2 $$
Escapado de Caracteres Especiales
Para escapar caracteres especiales, usa una barra diagonal inversa ().
Ejemplo
\*Itálica\* o \_itálica\_
Esta hoja de trucos exhaustiva cubre la sintaxis esencial de Markdown que necesitas para crear documentos bien formateados. Para características más avanzadas y personalizaciones, consulta la documentación específica del renderizador o recursos adicionales. Si usas Hugo, la Hoja de Trucos de Comandos de Hugo es una referencia complementaria útil.
Markdown también es el formato de almacenamiento predeterminado para wikis autoalojadas y sistemas de conocimiento. DokuWiki utiliza un enfoque de texto plano amigable con Markdown para bases de conocimiento personales y de equipo. Para sistemas de conocimiento asistidos por IA basados en páginas de Markdown, LLM Wiki explica por qué la portabilidad y la capacidad de diff del formato lo convierten en la base adecuada para el conocimiento compilado.
