Hoja de referencia rápida: Sintaxis, formateo y estructura en Markdown
Guía rápida de Markdown: encabezados, listas, código, tablas y más.
El lenguaje Markdown se utiliza en Wikipedia y Hugo. Tiene soporte para encabezados, listas, modificaciones del estilo de la fuente, imágenes, citas de código y tablas. Aquí mantengo un breve resumen del formato Markdown.
La imagen anterior fue producida por Flux - texto a imagen AI.
Markdown es un lenguaje de marcado ligero que puedes utilizar para agregar elementos de formato a documentos de texto plano. Esta guía ofrece una visión general completa de la sintaxis de Markdown más utilizada, ayudándote a crear documentos bien estructurados y visualmente atractivos.
Este manual es parte del Herramientas de Documentación en 2026: Markdown, LaTeX, PDF y Flujos de Trabajo de Impresión centro de recursos.
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 ofrece 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 no ordenadas
Markdown admite tanto listas ordenadas como no ordenadas.
Lista no ordenada
- 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 en corchetes ([]) y luego envolviendo la URL en paréntesis (().
[Texto del enlace](URL)
Ejemplo
Visita [Guía de Markdown](https://www.markdownguide.org/) para obtener más información.
Incluir imágenes
Las imágenes se añaden usando un signo de exclamación (!) seguido del texto alternativo en corchetes y la URL de la imagen en paréntesis.
Ejemplo
Citas y citas anidadas
Las citas se crean usando el símbolo de mayor que (>).
> Esta es una cita.
Citas anidadas
> Esta es la primera capa de citación.
>> Esta es una cita anidada.
Código en línea y bloques de código
Puedes añadir código en línea envolviéndolo en comillas invertidas (` ). Para bloques de código, usa tres 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
def hello_world(): print("Hello, World!")
```
Más información sobre bloques de código en Markdown, consulta el post separado: Usando bloques de código en Markdown
Reglas horizontales (divisores)
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, formateo de múltiples columnas y características específicas de GFM, consulta Tablas en Markdown: Guía Completa.
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 un texto tachado.~~
Resaltado de texto
El resaltado de texto no está nativamente soportado en Markdown, pero algunos renderizadores lo admiten usando la sintaxis ==.
Ejemplo
==Este es un texto resaltado.==
Subíndices y superíndices
Los subíndices se crean usando un acento circunflejo (^) antes del texto, y los superíndices se crean usando un tilde (~) antes del texto.
Ejemplo
H~2~O es agua.
E = mc^2
Ecuaciones matemáticas (sintaxis LaTeX)
Las ecuaciones matemáticas se pueden agregar usando la sintaxis LaTeX dentro de signos de dólar ($).
Ejemplo
$$ E = mc^2 $$
Escapar caracteres especiales
Para escapar caracteres especiales, usa una barra invertida ().
Ejemplo
\*Itálica\* o \_itálica\_
Este completo manual cubre la sintaxis esencial de Markdown que necesitas para crear documentos bien formateados. Para características avanzadas y personalizaciones, consulta la documentación específica del renderizador o recursos adicionales. Si usas Hugo, el Hoja de Referencia de Comandos de Hugo es una referencia útil.
