Hoja de trucos de Markdown

Paso 1 / 3 33%

Elige un tema de Markdown

Empieza por un grupo de ejemplos y después abre la referencia completa.

Sintaxis esencial de Markdown, agrupada por categorías y mostrada con el código listo para copiar y la salida de un analizador real. Incluye las bases de CommonMark (encabezados, listas, énfasis, enlaces, imágenes y código cercado) y extensiones de GitHub Flavored Markdown (tablas, listas de tareas, tachado y enlaces automáticos de URL sin formato). Tenla a mano cuando cambies entre GitHub, GitLab, Obsidian y generadores de sitios estáticos.

Cómo usar la hoja de trucos

  1. 1

    Navegar por categoría

    Filtra la referencia completa o elige un tema en la vista guiada.

  2. 2

    Comparar fuente y resultado

    Cada ejemplo muestra el Markdown en bruto junto a la salida de un analizador GFM real.

  3. 3

    Copia el fragmento

    Toca copiar para obtener el código fuente de cualquier ejemplo.

  4. 4

    Revisa la etiqueta de sintaxis

    Cada ejemplo está marcado como CommonMark o GitHub Flavored Markdown (GFM).

Encabezados

# Título H1
## Sección H2
### Subsección H3

Usa el estilo ATX (#) en lugar de Setext (=== debajo del texto). Todos los analizadores soportan ambos, pero ATX es más fácil de leer en un diff.

Énfasis

*cursiva* o _cursiva_, **negrita** o __negrita__, ***negrita cursiva***. GFM añade ~~tachado~~.

Listas

Las listas desordenadas usan -, * o + (elige uno y no lo cambies):

- Primero
- Segundo
  - Anidado (dos espacios)

Las listas ordenadas se renumeran automáticamente:

1. Elemento
1. Elemento
1. Elemento

Código

En línea: `código`. Bloques cercados con etiqueta de lenguaje opcional:

```python
def hello(name):
    return f"Hola, {name}"
```

Indenta con cuatro espacios para un bloque de código si prefieres la sintaxis más antigua.

Enlaces e imágenes

[Texto del enlace](https://example.com)
[Enlace con título](https://example.com "Tooltip")
![Texto alternativo](/path/to/image.png)

El estilo de referencia mantiene URLs largas fuera del párrafo:

Consulta los [docs][1].

[1]: https://example.com/docs

Tablas (GFM)

| Col A | Col B |
|-------|------:|
| a     |     1 |
| b     |    22 |

La alineación usa dos puntos en la fila separadora: :--- izquierda, :---: centro, ---: derecha.

Listas de tareas (GFM)

- [x] Hecho
- [ ] Por hacer

Problemas comunes

  • Dos espacios finales insertan un salto de línea dentro de un párrafo. Un espacio solo une las líneas.
  • Línea en blanco requerida antes de la mayoría de los elementos de bloque (encabezados, listas, bloques de código).
  • No indentes los marcadores de lista con tabulaciones si tu renderizador espera espacios; indenta con dos o cuatro espacios.
  • Escapa con barra invertida para puntuación literal: \*no cursiva\*.
  • Comillas inteligentes difieren según el renderizador. GitHub las deja como están; Pandoc las convierte.

Preguntas frecuentes

CommonMark define el núcleo portable, incluidos encabezados, listas, enlaces y código cercado con una etiqueta informativa opcional. GFM añade tablas, listas de tareas, tachado y enlaces automáticos para URL sin formato. Otros editores pueden implementar solo una parte o añadir extensiones propias.

En un archivo Markdown, un único salto de línea suele ser un salto suave. Para crear un salto duro en CommonMark o GFM, termina la primera línea con dos espacios o una barra invertida.

CommonMark reconoce HTML en bruto, pero cada plataforma decide si lo permite, lo limpia o lo escapa. GitHub limpia el HTML renderizado y esta guía lo escapa en las vistas previas por seguridad.

CommonMark no incluye una sintaxis de tabla de contenido. GitHub crea anclas de encabezado y muestra un esquema en archivos con varios encabezados. Otras plataformas tienen sus propias reglas: MkDocs puede usar [TOC] con la extensión correspondiente y Docusaurus genera la tabla de contenido a partir de los encabezados.

Los ejemplos de CommonMark y muchos de GFM sí. Obsidian también admite wikilinks ([[Nombre de la página]]), callouts e incrustaciones propios; esas extensiones quedan fuera de esta guía.

Herramientas relacionadas