Markdown Cheat Sheet: guía rápida con toda la sintaxis y ejemplos (2026)

Guarda esta página en marcadores. O consigue la versión gratuita en PDF de la guía de referencia de Markdown para tenerla a mano sin conexión.

La sintaxis de Markdown de un vistazo

¿Qué es Markdown?

Markdown es una sintaxis de formato en texto plano creada por John Gruber y Aaron Swartz en 2004. Usa símbolos sencillos para dar formato al texto de modo que pueda convertirse en HTML y otros formatos. El objetivo era la legibilidad. Un archivo Markdown debe verse limpio como texto plano y solo volverse más bonito al renderizarse.

Hoy Markdown está en todas partes. Los README de GitHub, las publicaciones de Reddit, los mensajes de Discord, las páginas de Notion, las notas de Obsidian, las respuestas de los chatbots de IA y la mayoría de los sitios de documentación lo usan. Si escribes cualquier cosa en una computadora en 2026, es casi seguro que estás produciendo Markdown, te des cuenta o no.

Para saber más sobre el formato en sí, lee qué es un archivo .md, cómo abrir y leer un archivo .md o Markdown vs HTML para entender en qué se diferencian ambos formatos. Para una referencia completa, elemento por elemento, consulta la documentación de Markdown.

Encabezados

Usa símbolos # al principio de una línea para crear encabezados. El número de símbolos # define el nivel del encabezado, desde H1 (el más grande) hasta H6 (el más pequeño).

# Encabezado 1
## Encabezado 2
### Encabezado 3
#### Encabezado 4
##### Encabezado 5
###### Encabezado 6

Sintaxis alternativa de encabezados (Setext)

Solo para H1 y H2, puedes usar encabezados con estilo de subrayado:

Encabezado 1
=========

Encabezado 2
---------

La mayoría de quienes escriben se quedan con la sintaxis # porque funciona en todos los niveles y es más fácil de leer de un vistazo.

Consejos:

• Pon siempre un espacio entre el # y el texto del encabezado
• Usa solo un H1 por documento (es el título)
• Deja una línea en blanco antes y después de los encabezados para un renderizado más seguro

Guía completa: Encabezados en Markdown →

Párrafos y saltos de línea

Los párrafos se separan con una línea en blanco. Basta con presionar Enter dos veces.

Este es el primer párrafo.

Este es el segundo párrafo.

Saltos de línea dentro de un párrafo

Para romper una línea sin empezar un párrafo nuevo, termina la línea con dos espacios seguidos de Enter, o usa una barra invertida \:

Primera línea.
Segunda línea en una nueva línea, mismo párrafo.

Primera línea.\
Segunda línea usando barra invertida.

Ambos producen una etiqueta <br> en HTML. El método de los espacios finales es más tradicional, pero es invisible en tu editor, lo que genera confusión. El método de la barra invertida es más claro y compatible con GitHub Flavored Markdown.

Guía completa: Párrafos → · Saltos de línea →

Negrita, cursiva y otros formatos de texto

Estos son los formatos básicos que usarás constantemente.

**texto en negrita** o __texto en negrita__
*texto en cursiva* o _texto en cursiva_
***negrita y cursiva*** o ___negrita y cursiva___
~~texto tachado~~

La negrita y la cursiva forman parte del núcleo de CommonMark y funcionan en todas partes. El tachado es una extensión de GFM que se explica con más detalle más abajo.

Cuándo usar asteriscos y cuándo guiones bajos

Tanto ** como __ producen negrita. Tanto * como _ producen cursiva. Son intercambiables, así que elige uno y mantenlo por coherencia.

La diferencia práctica aparece dentro de una palabra. CommonMark y GFM ignoran los guiones bajos entre letras, por lo que los guiones bajos permanecen literales, mientras que los asteriscos siempre activan el énfasis:

Permanece literal:  this_word_has_underscores
Se vuelve cursiva:  this*word*has*asterisks

Usa guiones bajos en textos que contengan guiones bajos (como file_name) para evitar cursivas accidentales, y usa asteriscos cuando de verdad quieras dar énfasis dentro de una palabra:

un**believ**ably

Guía completa: Énfasis: negrita y cursiva →

Listas

Las listas vienen en dos variantes: desordenadas (viñetas) y ordenadas (numeradas).

Listas desordenadas

Usa -, * o + seguido de un espacio. Las tres funcionan igual. La mayoría de las guías de estilo prefieren -.

- Primer elemento
- Segundo elemento
- Tercer elemento
  - Elemento anidado (sangría de 2 o 4 espacios)
  - Otro elemento anidado
    - Elemento anidado profundo
- Cuarto elemento

Listas ordenadas

Usa números seguidos de un punto. Los números concretos no importan, Markdown vuelve a numerar automáticamente:

1. Primer elemento
2. Segundo elemento
3. Tercer elemento
   1. Elemento anidado
   2. Otro elemento anidado
4. Cuarto elemento

También puedes escribir esto y obtener el mismo resultado:

1. Primer elemento
1. Segundo elemento
1. Tercer elemento

Esto es una función, no un fallo. Significa que puedes reordenar los elementos de la lista sin volver a numerarlos a mano.

Listas mixtas

Puedes anidar listas desordenadas dentro de ordenadas y viceversa:

1. Paso uno
2. Paso dos
   - Subpunto A
   - Subpunto B
3. Paso tres

Guía completa: Listas en Markdown →

Enlaces

Los enlaces usan corchetes para el texto visible y paréntesis para la URL.

Enlaces en línea básicos

[Markdific](https://markdific.com)
[Visita nuestro blog](https://markdific.com/blog "Título opcional al pasar el cursor")

Enlaces automáticos

Envuelve una URL entre corchetes angulares para autoenlazarla:

<https://markdific.com>
<[email protected]>

Enlaces por referencia

Útiles cuando el mismo enlace aparece varias veces o cuando quieres mantener limpio el texto:

Lee nuestra [guía de referencia][1] o el [blog][2].

Más adelante en el documento o al final:

[1]: https://markdific.com/resources/markdown-cheat-sheet
[2]: https://markdific.com/blog/

También puedes usar referencias con nombre:

Echa un vistazo a [Markdific][md-home].

[md-home]: https://markdific.com

Enlazar a secciones (enlaces de anclaje)

GitHub y la mayoría de los renderizadores generan automáticamente identificadores de anclaje a partir del texto del encabezado (en minúsculas, con los espacios sustituidos por guiones):

[Ir a Tablas](#tables)
[Ir a Alertas de GitHub](#github-alerts)

Guía completa: Enlaces → · Enlaces automáticos → · Identificadores de encabezado →

Wikilinks e inserciones (embeds)

Obsidian, y algunas otras herramientas de notas, añaden wikilinks e inserciones con doble corchete además del Markdown estándar:

[[Título de la nota]]            enlace a otra nota
[[Título de la nota|Alias]]      enlace con texto personalizado
![[Título de la nota]]           inserta el contenido de otra nota
![[image.png]]                   inserta una imagen

Son una extensión de Obsidian, no Markdown estándar, así que no se resuelven en GitHub ni en la mayoría de los sitios estáticos. Consulta Markdown en Obsidian para ver el conjunto completo.

Imágenes

La sintaxis de las imágenes es casi idéntica a la de los enlaces, con un signo de exclamación delante.

![Texto alternativo que describe la imagen](path/to/image.jpg)
![Texto alternativo](path/to/image.jpg "Título opcional al pasar el cursor")

Tamaño de la imagen

El Markdown puro no admite el dimensionado de imágenes. Tienes dos opciones:

Opción 1: usar HTML directamente

<img src="path/to/image.jpg" alt="Descripción" width="500">

Opción 2: usar extensiones específicas de la plataforma

Obsidian, por ejemplo, admite:

![[image.jpg|500]]

Imágenes por referencia

![Logo de Markdific][logo]

[logo]: /images/logo.png "Markdific"

Enlazar una imagen

Para convertir una imagen en un enlace, envuelve la sintaxis de la imagen dentro de un enlace:

[![Texto alternativo](image.jpg)](https://destination-url.com)

Para los casos que el Markdown puro no cubre, archivos locales, dimensionado preciso o imágenes incrustadas en Base64, usa la etiqueta HTML <img> sin procesar que se muestra arriba.

Guía completa: Imágenes en Markdown →

Código y bloques de código

El formato de código es una de las funciones más útiles de Markdown.

Código en línea

Envuelve el código en comillas invertidas simples:

Usa la función `print()` en Python.

Si tu código contiene una comilla invertida, envuélvelo en comillas invertidas dobles:

El carácter `` ` `` se llama comilla invertida.

Bloques de código cercados

Usa tres comillas invertidas para bloques de código de varias líneas. Añade un identificador de lenguaje después de las comillas invertidas de apertura para el resaltado de sintaxis:

```python
def hello_world():
    print("Hello, world!")
```

```javascript
function helloWorld() {
  console.log("Hello, world!");
}
```

```bash
npm install markdown-it
```

Identificadores de lenguaje comunes

• python, py
• javascript, js
• typescript, ts
• bash, sh, shell
• html, xml
• css, scss
• json, yaml
• sql, graphql
• markdown, md
• diff (para diffs de git)
• plaintext, text (sin resaltado)

Bloques de código con sangría (heredado)

Aplica a cualquier línea una sangría de cuatro espacios o una tabulación para convertirla en un bloque de código. Esto funciona, pero es menos legible que los bloques cercados. Evítalo.

Guía completa: Código → · Bloques de código cercados → · Resaltado de sintaxis →

Citas

Usa > al principio de una línea para crear una cita.

> Esto es una cita.
> Puede abarcar varias líneas.

> También puedes tener una cita de una sola línea.

Citas anidadas

Apila caracteres >:

> Cita exterior.
>
> > Cita anidada.
> >
> > > Cita anidada en profundidad.

Citas con otro Markdown

Las citas pueden contener encabezados, listas, código y otros formatos:

> ### Un encabezado dentro de una cita
>
> - Un elemento de lista
> - Otro elemento
>
> Algo de `código en línea` y **texto en negrita**.

Guía completa: Citas →

Líneas horizontales

Tres o más guiones, asteriscos o guiones bajos en su propia línea:

---
***
___

Los tres se renderizan como <hr>. Úsalos con moderación. La mayoría de los documentos modernos usan la jerarquía de encabezados en su lugar.

Guía completa: Líneas horizontales →

Tablas

Las tablas son una extensión de GitHub Flavored Markdown, no CommonMark estándar, pero hoy son compatibles casi en todas partes.

Tabla básica

| Encabezado 1 | Encabezado 2 | Encabezado 3 |
|----------|----------|----------|
| Celda 1   | Celda 2   | Celda 3   |
| Celda 4   | Celda 5   | Celda 6   |

Alineación de columnas

Añade dos puntos a la línea separadora:

| Alineado a la izquierda | Centrado | Alineado a la derecha |
|:-------------|:--------------:|--------------:|
| Texto         | Texto           | Texto          |
| Texto más largo  | Texto más largo    | Texto más largo   |

• :--- alinear a la izquierda (predeterminado)
• :---: centrar
• ---: alinear a la derecha

Consejos para tablas más limpias

• Las barras verticales exteriores son opcionales, pero mejoran la legibilidad
• El ancho de las columnas en el origen no afecta a la salida (los renderizadores ignoran los espacios de más)
• Los caracteres de barra vertical dentro de las celdas deben escaparse como \|
• Las tablas estándar de GFM no pueden tener celdas multilínea ni celdas combinadas; usa HTML para eso

Para una guía completa que incluye cómo manejar tablas complejas, además de nuestro generador de tablas de Markdown gratuito, lee nuestra guía completa de tablas en Markdown.

Guía completa: Tablas en Markdown →

Listas de tareas

Las listas de tareas (también llamadas listas de pendientes) son una extensión de GFM compatible con GitHub, GitLab y la mayoría de los editores modernos.

- [x] Tarea completada
- [ ] Tarea pendiente
- [ ] Otra tarea pendiente
  - [x] Subtarea anidada completada
  - [ ] Subtarea anidada pendiente

La [x] distingue entre mayúsculas y minúsculas en algunos renderizadores. Usa x en minúscula para estar seguro.

Guía completa: Listas de tareas →

Notas al pie

Las notas al pie son una extensión de GitHub, y también son compatibles con MultiMarkdown y Pandoc. Son perfectas para citas y comentarios aparte.

Esta es una frase con una nota al pie.[^1]

Puedes tener varias notas al pie.[^note]

[^1]: Este es el contenido de la primera nota al pie.
[^note]: Esta es una nota al pie con nombre y contenido más largo
    que puede abarcar varias líneas si se aplica sangría.

Las notas al pie se numeran automáticamente y aparecen al final del documento renderizado con enlaces de retorno.

Guía completa: Notas al pie →

Listas de definición

Las listas de definición son compatibles con Pandoc, MultiMarkdown y algunas otras variantes, pero no con el núcleo de GFM.

Término
: Definición del término.

Markdown
: Un lenguaje de marcado ligero para crear texto con formato.
: Creado por John Gruber en 2004.

Comprueba tu renderizador de destino antes de fiarte de estas. Son inconsistentes entre plataformas.

Guía completa: Listas de definición →

Abreviaturas

MultiMarkdown y PHP Markdown Extra permiten definir una abreviatura una sola vez y que se expanda dondequiera que aparezca el término:

La especificación HTML la mantiene el W3C.

*[HTML]: HyperText Markup Language
*[W3C]: World Wide Web Consortium

Esto no forma parte de CommonMark ni de GFM, así que la mayoría de los renderizadores (incluido GitHub) muestran las líneas de definición como texto literal. Úsalo solo donde sepas que el destino lo admite.

Tachado

Envuelve el texto entre dobles tildes:

~~Este texto está tachado~~

Renderizado: Este texto está tachado

Extensión de GFM. Compatible de forma universal en los renderizadores modernos.

Guía completa: Tachado →

Subíndice, superíndice y resaltado

Estas tres marcas en línea son funciones extendidas. Ninguna forma parte del núcleo de CommonMark ni de GitHub Flavored Markdown, así que la compatibilidad varía, pero cada una tiene una alternativa fiable en HTML que funciona en cualquier parte.

Subíndice y superíndice

Pandoc, MultiMarkdown y unas cuantas otras variantes admiten la sintaxis de tilde y acento circunflejo:

El agua es H~2~O.
El área es 10 m^2^.

Donde esa sintaxis no es compatible (GitHub y la mayoría de los renderizadores de CommonMark), usa las etiquetas HTML en su lugar, se renderizan en todas partes:

El agua es H<sub>2</sub>O.
El área es 10 m<sup>2</sup>.

Resaltado

Obsidian y algunas otras herramientas resaltan el texto envuelto entre dobles signos de igual:

Markdown hace que ==esta parte== destaque.

Para los renderizadores que no admiten ==, usa la etiqueta HTML <mark>: <mark>resaltado</mark>.

Guía completa: Subíndice y superíndice → · Resaltado →

Emoji

Tres formas de usar emojis en Markdown:

1. Pegar directamente

Simplemente escribe o pega el carácter de emoji real: 🎉 ✅ 🚀

Esto funciona en todas partes porque los emojis no son más que caracteres Unicode.

2. Códigos abreviados (GFM)

GitHub y GitLab admiten la sintaxis de código abreviado que convierte códigos de texto en emojis:

:tada: :white_check_mark: :rocket:

Estos se renderizan como 🎉 ✅ 🚀 en las plataformas compatibles. Discord y Slack usan una sintaxis :code: similar, pero con sus propias bibliotecas de emojis, así que los códigos disponibles difieren. Consulta Markdown en Discord y Markdown en Slack para ver cómo maneja el formato cada aplicación de chat.

3. Entidades HTML

Para máxima compatibilidad también puedes usar códigos de entidad HTML, aunque los códigos abreviados son mucho más legibles.

Guía completa: Emojis en Markdown →

HTML en Markdown

Puedes incrustar HTML sin procesar dentro de Markdown para los casos que la sintaxis no cubre:

<details>
<summary>Haz clic para expandir</summary>

Este contenido está oculto por defecto y se muestra cuando el usuario hace clic.

</details>

Usos habituales del HTML sin procesar:

• <details> y <summary> para secciones plegables
• <sub> y <sup> para subíndice y superíndice
• <kbd> para teclas del teclado (se renderiza con estilo Ctrl + C)
• <mark> para resaltado
• <img> con atributos de ancho para imágenes dimensionadas
• Tablas con celdas combinadas, celdas multilínea o diseños complejos

Ejemplo de teclas del teclado

Presiona <kbd>Ctrl</kbd> + <kbd>C</kbd> para copiar.

Advertencias

Algunas plataformas eliminan o depuran el HTML por seguridad (Reddit, por ejemplo). GitHub permite la mayor parte del HTML, pero bloquea <script> y algunas otras etiquetas. Prueba siempre en tu plataforma de destino.

Guía completa: HTML en línea en Markdown →

Comentarios

Markdown no tiene una sintaxis oficial de comentarios, pero hay dos formas fiables de dejar notas en un archivo que nunca aparecen en la salida renderizada.

Comentarios HTML

Cualquier renderizador que permita HTML también respeta los comentarios HTML:

<!-- Esta nota es invisible en la página renderizada. -->

El contenido visible continúa aquí.

El comentario se omite cuando se renderiza el archivo. Aun así sigue existiendo en el código fuente HTML, así que trátalo como oculto para los lectores en lugar de verdaderamente privado.

El truco del enlace de referencia

Para los renderizadores que eliminan el HTML (algunas aplicaciones de chat y visores en sandbox), usa una definición de enlace de referencia vacía. No produce salida porque nada la enlaza nunca:

[//]: # (Este es un comentario que no renderiza nada.)

[comment]: # (Otra forma de escribir lo mismo.)

Esto funciona en casi todos los analizadores porque una definición de enlace que nunca se referencia simplemente se descarta. Es la forma más portable de ocultar una nota.

Caracteres de escape

Para mostrar un carácter de Markdown de forma literal, precédelo con una barra invertida:

\* Esto no es cursiva \*
\# Esto no es un encabezado
\[Esto no es un enlace\](not-a-url)

Caracteres que puedes escapar:

\ `` * _ {} [] () # + - . ! |`

Guía completa: Escapar caracteres →

Ecuaciones matemáticas (LaTeX)

Las matemáticas son compatibles con GitHub, GitLab, Obsidian, Notion y la mayoría de las herramientas de documentación modernas como función del renderizador. Usa sintaxis LaTeX dentro de signos de dólar.

Matemáticas en línea

Signos de dólar simples para matemáticas en línea:

El teorema de Pitágoras es $a^2 + b^2 = c^2$.

GitHub también admite un delimitador en línea alternativo que envuelve las matemáticas entre un signo de dólar y una comilla invertida a cada lado, para los casos en que tus matemáticas contienen caracteres que entran en conflicto con Markdown:

Aquí $`a + b = c`$ usa los delimitadores alternativos.

Matemáticas en bloque

Signos de dólar dobles para ecuaciones a nivel de bloque:

$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

Patrones comunes de LaTeX

Fracciones:       $\frac{a}{b}$
Raíz cuadrada:    $\sqrt{x}$
Potencias:        $x^{2}$
Subíndices:       $x_{i}$
Letras griegas:   $\alpha, \beta, \gamma, \pi, \theta$
Sumatorio:        $\sum_{i=1}^{n} i$
Integral:         $\int_{0}^{1} x \, dx$
Matriz:           $\begin{pmatrix} a & b \\ c & d \end{pmatrix}$

Los renderizadores varían en la sintaxis. GitHub usa MathJax. Algunas plataformas requieren KaTeX, que tiene convenciones ligeramente distintas.

Guía completa: Matemáticas con LaTeX →

Diagramas Mermaid

Mermaid es una biblioteca de JavaScript que convierte texto en diagramas. GitHub, GitLab, Notion, Obsidian y la mayoría de los renderizadores de Markdown modernos lo admiten de forma nativa. Es una de las funciones más útiles del Markdown moderno.

Diagrama de flujo

```mermaid
flowchart TD
    A[Inicio] --> B{¿Funciona?}
    B -->|Sí| C[Publicarlo]
    B -->|No| D[Depurar]
    D --> B
```

Diagrama de secuencia

```mermaid
sequenceDiagram
    Usuario->>Navegador: Abrir archivo .md
    Navegador->>Markdific: Renderizar markdown
    Markdific-->>Navegador: Devolver HTML
    Navegador-->>Usuario: Mostrar página con formato
```

Otros tipos de diagramas de Mermaid

• flowchart (flujos de procesos)
• sequenceDiagram (interacciones a lo largo del tiempo)
• classDiagram (clases UML)
• stateDiagram-v2 (máquinas de estados)
• erDiagram (esquemas de bases de datos)
• gantt (cronogramas de proyectos)
• pie (gráficos circulares)
• mindmap (mapas mentales)
• journey (recorridos de usuario)
• gitGraph (visualizaciones de ramas de git)

Mermaid admite muchos más tipos de diagramas de los que se muestran aquí. Cuáles se renderizan depende de la versión de Mermaid de tu herramienta. GitHub y GitLab mantienen la suya actualizada, así que la mayoría de los tipos de diagramas funcionan de inmediato.

Guía completa: Diagramas Mermaid →

Alertas de GitHub

Las alertas de GitHub (también llamadas "callouts" o "admonitions") son una función de GitHub lanzada a finales de 2023. Renderizan citas especiales con iconos y colores, y ahora tienen amplia compatibilidad en otros renderizadores de Markdown.

> [!NOTE]
> Información útil que los usuarios deberían conocer.

> [!TIP]
> Consejos útiles para hacer las cosas mejor.

> [!IMPORTANT]
> Información clave que los usuarios necesitan conocer.

> [!WARNING]
> Información urgente que necesita atención inmediata.

> [!CAUTION]
> Advierte sobre riesgos o resultados negativos.

Los cinco tipos admitidos son NOTE, TIP, IMPORTANT, WARNING y CAUTION. Otras herramientas de Markdown (Obsidian, MkDocs, Docusaurus) usan una sintaxis similar pero ligeramente diferente para los callouts. Consulta Markdown en GitHub para ver cómo se renderizan las alertas y otras funciones de GitHub.

Frontmatter YAML

El frontmatter es un bloque de metadatos YAML al principio de un archivo Markdown, usado por generadores de sitios estáticos (Hugo, Jekyll, Astro, Next.js), plataformas CMS y aplicaciones de notas.

---
title: "Título de mi artículo"
date: 2026-01-15
author: Jane Doe
tags:
  - markdown
  - tutorial
  - referencia
draft: false
description: Un breve resumen para SEO.
---

# El contenido del artículo empieza aquí

Tres guiones abren y cierran el bloque. Dentro, usa sintaxis YAML estándar. Campos habituales:

• title
• date
• author o authors
• tags o categories
• description (para las metaetiquetas)
• draft (booleano)
• slug o permalink
• image (ruta de la imagen destacada)

El frontmatter es invisible en la salida renderizada. Son solo metadatos para el sistema que procesa el archivo.

Si tu frontmatter aparece como texto literal en la salida, probablemente el analizador no lo admite. Comprueba que el archivo empiece en la línea 1 con --- y no tenga ninguna línea en blanco por encima.

Guía completa: Frontmatter →

Comparación de las variantes (flavors) de Markdown

Markdown tiene varias "variantes" (flavors) con funciones diferentes. Saber cuál usa tu plataforma de destino evita renderizados rotos.

En caso de duda, escribe GFM. Es lo más parecido a un estándar universal de Markdown en 2026. Para el comportamiento específico de cada plataforma, consulta Markdown en Obsidian y Markdown en Notion.

Guía completa: Comparación de variantes de Markdown →

Errores comunes

Estos hacen tropezar a quienes escriben constantemente. Evítalos.

1. Olvidar las líneas en blanco

Markdown a menudo necesita una línea en blanco entre elementos:

Esto es un párrafo.
- Esta lista podría no renderizarse
- según el renderizador.

Se soluciona con una línea en blanco:

Esto es un párrafo.

- Esta lista se renderiza correctamente.
- Todos los renderizadores coinciden.

2. Mezclar la sangría

Al anidar listas o añadir párrafos a los elementos de una lista, usa una sangría coherente (2 o 4 espacios). Mezclar tabulaciones y espacios rompe el renderizado.

3. Espacios finales para los saltos de línea

El truco de "dos espacios al final de la línea" para saltos de línea suaves es invisible y se rompe con facilidad. Usa una barra invertida en su lugar, o simplemente acepta que los párrafos suelen ser lo que quieres.

4. No escapar los caracteres especiales

Escribir func_name_with_underscores en el texto es seguro en CommonMark y GFM, que ignoran los guiones bajos entre letras, aunque algunos analizadores más antiguos aún los leen como énfasis. Los asteriscos son más arriesgados aquí, ya que a*b*c pone en cursiva. Para estar seguro en todas partes, envuelve los términos técnicos en comillas invertidas como código en línea. Otras colisiones comunes: < y > interpretados como etiquetas HTML, y | dentro de las celdas de una tabla, que rompe el diseño de la tabla.

5. Depender de funciones no estándar

Si usas wikilinks de Obsidian [[note]] y luego publicas en un sitio estático que no los admite, tus enlaces se rompen. Conoce tu renderizador de destino.

6. Tablas demasiado anchas

Las tablas de GFM no pueden desplazarse horizontalmente. Si una tabla es demasiado ancha para la página, se desborda. Divide las tablas anchas en varias más estrechas o usa HTML.

7. Encabezados vacíos o encabezados solo con formato

## **Encabezado en negrita**

Esto funciona, pero algunos renderizadores eliminan el formato de los encabezados o generan identificadores de anclaje extraños. Mantén los encabezados sencillos.

Descarga la guía de referencia en PDF

¿Quieres esta guía de referencia sin conexión? Descarga la versión imprimible en PDF para tenerla en tu escritorio o compartirla con tu equipo.

Preguntas frecuentes

¿Qué es una guía de referencia de Markdown?

Una guía de referencia de Markdown es una referencia rápida que enumera cada elemento de la sintaxis de Markdown junto a un ejemplo de cómo escribirlo, encabezados, texto en negrita y cursiva, listas, enlaces, imágenes, bloques de código, tablas y más. Esta página cubre todo CommonMark más las extensiones de GitHub Flavored Markdown.

¿Cómo pongo texto en negrita en Markdown?

Envuelve el texto entre dos asteriscos: **texto en negrita**. Dos guiones bajos (__texto en negrita__) también funcionan. Para cursiva, usa un solo asterisco o guion bajo; para negrita y cursiva a la vez, usa tres: ***texto***.

¿Cómo creo una tabla en Markdown?

Separa las columnas con barras verticales y añade una fila de guiones bajo la fila de encabezado para marcarla como tabla:

| Nombre | Rol |
|------|------|
| Ada  | Líder |

O sáltate la sintaxis por completo y crea una visualmente con nuestro generador de tablas de Markdown gratuito.

¿Cuál es la diferencia entre Markdown y GitHub Flavored Markdown?

CommonMark es la sintaxis del núcleo estandarizado. GitHub Flavored Markdown (GFM) lo extiende con tablas, listas de tareas, tachado, enlaces automáticos, notas al pie y alertas. GFM es la variante con más compatibilidad, así que es la opción por defecto más segura en 2026.

¿Markdown es lo mismo que HTML?

No. Markdown es una sintaxis ligera en texto plano que se convierte en HTML. Markdown es para escribir y editar; HTML es para mostrar. Nuestra guía de Markdown vs HTML explica cuándo usar cada uno.

¿Cómo añado un enlace en Markdown?

Pon el texto visible entre corchetes seguido de la URL entre paréntesis: [Markdific](https://markdific.com). Para convertir una imagen en un enlace, envuelve la sintaxis de la imagen entre los mismos corchetes.

¿Cómo añado un comentario en Markdown?

Markdown no tiene una sintaxis oficial de comentarios. El método más portable es un enlace de referencia vacío, [//]: # (tu nota), que no renderiza nada. En cualquier renderizador que permita HTML, un comentario HTML <!-- tu nota --> también funciona.

¿Cómo creo una lista de verificación en Markdown?

Usa una lista de tareas: empieza cada elemento con - [ ] para una tarea pendiente o - [x] para una completada. Las listas de tareas son una función de GitHub Flavored Markdown compatible con GitHub, GitLab y la mayoría de los editores modernos.

¿Cómo añado una imagen en Markdown?

Usa un signo de exclamación, el texto alternativo entre corchetes y la ruta entre paréntesis: ![Texto alternativo](path/to/image.jpg). Para dimensionar una imagen, usa una etiqueta HTML <img> con un atributo width en su lugar.

¿Cómo escribo un bloque de código en Markdown?

Envuelve el código entre tres comillas invertidas en sus propias líneas. Añade el nombre de un lenguaje después de las comillas invertidas de apertura para el resaltado de sintaxis. Para un fragmento corto dentro de una frase, usa comillas invertidas simples alrededor del código.

¿Cómo hago una tabla de contenidos en Markdown?

Markdown no tiene una tabla de contenidos integrada, pero puedes crear una a partir de enlaces de anclaje como [Título de la sección](#section-title), usando el encabezado en minúsculas con los espacios sustituidos por guiones. GitHub, GitLab y muchos editores también generan una automáticamente.

¿Cómo convierto Markdown a Word o PDF?

Usa un conversor. Markdific tiene herramientas gratuitas en línea para convertir Markdown a Word, PDF, HTML y más, todas funcionando en tu navegador sin registro.

Guías y herramientas relacionadas

Markdown por plataforma. Descubre exactamente cómo se comporta Markdown en las herramientas que usas cada día:

• Markdown en GitHub
• Markdown en Obsidian
• Markdown en Notion
• Markdown en VS Code
• Markdown en Discord
• Markdown en Slack
• Markdown en Jupyter
• Markdown en Confluence
• Cómo escribir un README
• Archivos Markdown para agentes de IA

Convierte tu Markdown. Conversores gratuitos en línea que funcionan en tu navegador, sin registro:

• Markdown a Word
• Markdown a PDF
• Markdown a HTML
• Markdown a Texto
• Markdown a Imagen
• Markdown a Google Docs

Puntos clave

Esa es toda la sintaxis de Markdown que de forma realista te encontrarás en 2026. Las conclusiones clave:

• CommonMark + GFM cubre el 95% del uso real de Markdown
• Tablas, listas de tareas, notas al pie, matemáticas, mermaid y alertas son las extensiones que vale la pena memorizar
• Las alternativas en HTML resuelven los casos límite que Markdown no cubre
• El frontmatter es esencial para cualquier sitio estático o sistema de contenidos
• Los diagramas Mermaid son una de las funciones más infrautilizadas de Markdown

El formato seguirá evolucionando a medida que el contenido generado por IA inunde la web de archivos .md, pero la sintaxis del núcleo ha sido estable desde 2004 y no va a cambiar. Apréndela una vez y da frutos durante décadas.

¿Quieres ver tu Markdown renderizado con claridad? Markdific es un visor y editor de Markdown rápido y dedicado para Mac y Windows. Para saber más, lee Markdown vs HTML, explora nuestros recursos de Markdown o lee la documentación de Markdown completa.

Markdific

Markdific convierte Markdown sin procesar en documentos limpios y legibles en cualquier dispositivo. Abre cualquier archivo .md y ve al instante encabezados, tablas, código, matemáticas e imágenes con el formato adecuado, luego edita con guardado automático, cambia de tema y exporta a PDF, Word o HTML.