Sintaxis Markdown: guía rápida

Toda la sintaxis de Markdown en una página: lo básico de la especificación original, las extensiones GitHub-Flavored y los extras que se usan en la documentación moderna. Copia cualquier ejemplo en el editor para verlo renderizado en vivo.

Probarlo en el editor

Gratis · sin registro · funciona en tu navegador, no se sube nada

Markdown Viewer en disposición dividida: código Markdown a la izquierda, vista previa renderizada al estilo GitHub a la derecha — Disposición dividida: el código y la vista previa renderizada uno junto al otro, con desplazamiento sincronizado línea a línea.

Sintaxis básica

Markdown	Se muestra como	Notas
`# Encabezado 1`	Encabezado 1	Hasta seis niveles: `######`
`## Encabezado 2`	Encabezado 2	Se requiere un espacio después de `#`
`negrita`	negrita	o `__negrita__`
`cursiva`	cursiva	o `_cursiva_`
`*negrita cursiva*`	*negrita cursiva*
`~~tachado~~`	~~tachado~~	GFM
`código en línea`	`código en línea`	Usa dos acentos graves para incluir un acento grave
`> cita`	cita	Anida con `> >`
`---`		Línea horizontal; también `***`
`línea uno\`	salto de línea	Una barra invertida final o dos espacios fuerzan un `<br>`
`\sin cursiva\`	sin cursiva	La barra invertida escapa cualquier signo de puntuación

Enlaces e imágenes

Markdown	Se muestra como	Notas
`[texto](https://example.com)`	texto	Enlace en línea
`[texto](https://example.com "Título")`	texto	Título opcional, se muestra al pasar el ratón
`<https://example.com>`	https://example.com	Autoenlace; las URL sueltas también se enlazan en GFM
`[texto][ref] … [ref]: https://example.com`	texto	Enlace por referencia, definido en cualquier parte
`[Encabezado 2](#encabezado-2)`	Encabezado 2	Ancla: minúsculas, espacios → guiones
`![texto alternativo](image.png)`	una imagen	Añade `"Título"` tras la URL para un tooltip
`[![alt](img.png)](https://link)`	una imagen clicable	Imagen dentro de un enlace

Listas

Markdown	Se muestra como	Notas
`- elemento - elemento`	elemento elemento	`*` y `+` también funcionan
`1. primero 2. segundo`	primero segundo	Los números no tienen que ser consecutivos
`- elemento - anidado`	elemento anidado	Sangra 2–4 espacios para anidar
`- [ ] pendiente - [x] hecho`	☐ pendiente ☑ hecho	Lista de tareas (GFM)
`1. paso párrafo`	un elemento de lista con dos párrafos	Sangra las líneas de continuación al nivel del texto

Pon una línea en blanco antes de una lista que sigue a un párrafo; si no, algunos renderizadores la tratan como parte del párrafo.

Tablas

| Izquierda | Centro | Derecha |
| :--- | :----: | ----: |
| a    |   b    |     c |

Izquierda	Centro	Derecha
a	b	c

La fila separadora define la alineación con dos puntos. Las celdas pueden contener formato en línea, enlaces y código; usa \| para una barra vertical literal. Las barras exteriores son opcionales.

Bloques de código

```javascript
const answer = 42;
```

Tres acentos graves (o virgulillas) abren y cierran un bloque delimitado; la palabra tras el delimitador de apertura define el lenguaje para el resaltado de sintaxis: js, python, bash, json, yaml, diff, sql y más de 50 más. Sangrar un bloque con cuatro espacios también crea un bloque de código, pero los delimitadores son más claros y permiten indicar un lenguaje. Para mostrar acentos graves dentro de un bloque, usa un delimitador más largo (cuatro acentos graves).

Extras de GitHub-Flavored

Markdown	Se muestra como	Notas
`> [!NOTE]`	aviso ⓘ Note	También `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
`texto[^1] … [^1]: La nota.`	texto¹ con la nota al final	Notas al pie
`:rocket: :sparkles:`	🚀 ✨	Códigos emoji
`<details><summary>Más</summary>…</details>`	una sección plegable	HTML en línea; deja una línea en blanco antes del Markdown interior
`<kbd>Ctrl</kbd>+<kbd>C</kbd>`	`Ctrl`+`C`	Teclas del teclado
`[[toc]]`	una tabla de contenido	Generada a partir de los encabezados (este visor)
`--- title: Doc ---`	front matter	Metadatos YAML al principio del archivo

Fórmulas y diagramas

Markdown	Se muestra como	Notas
$E = mc^2$	fórmula en línea	Sintaxis KaTeX / LaTeX
`$$ \int_0^1 x^2\,dx $$`	una fórmula centrada en modo bloque	En sus propias líneas
```mermaid flowchart LR A --> B ```	un diagrama de flujo	Mermaid: flowchart, sequence, class, state, gantt, pie…

Las fórmulas y Mermaid no forman parte del estándar Markdown, pero este visor, GitHub (Mermaid y fórmulas), Obsidian, Typora y la mayoría de las herramientas de documentación los admiten. Todos los tipos de diagrama Mermaid que dibuja este visor se enumeran en la página del editor Mermaid online.

Míralo en acción

Alertas Note, Important, Warning y Caution al estilo GitHub, una cita y una sección details plegable en el tema GitHub Dark — Alertas al estilo GitHub, citas y secciones <details> plegables, en GitHub Dark.

Fórmula KaTeX en modo bloque y diagrama de flujo Mermaid renderizados dentro de la vista previa — Las fórmulas KaTeX y los diagramas de flujo Mermaid se renderizan directamente en el documento.

Bloques de código TypeScript, Python, Bash y diff con resaltado de sintaxis, etiquetas de lenguaje y botones de copiar — Los bloques de código tienen etiqueta de lenguaje, resaltado de sintaxis para más de 50 lenguajes y botón de copiar; este es el tema One Dark.

Preguntas frecuentes

¿Qué es Markdown?

Un lenguaje de marcado ligero creado por John Gruber en 2004. Símbolos de texto plano como # y ** describen el formato, y un renderizador convierte el texto en HTML. Se usa en README, documentación, notas, mensajes de chat y respuestas de asistentes de IA.

¿Qué es GitHub-Flavored Markdown (GFM)?

La extensión de GitHub de la especificación CommonMark, que añade tablas, listas de tareas, tachado, autoenlaces y alertas. Es el estándar de facto para la documentación de desarrolladores y lo que renderiza este visor.

¿Cómo hago un salto de línea sin un párrafo nuevo?

Termina la línea con una barra invertida o con dos espacios. Una línea en blanco, en cambio, inicia un párrafo nuevo.

¿Cómo escapo caracteres especiales?

Pon una barra invertida delante: \* \_ \# \` \| \[ \]. Dentro de fragmentos y bloques de código no hace falta escapar nada.

¿Cómo añado una tabla de contenido?

Escribe [[toc]] en su propia línea en este visor, o enlaza a los encabezados manualmente con [Sección](#nombre-de-seccion).

¿Puedo probar estos ejemplos?

Sí: abre el editor, pega cualquier ejemplo y mira la vista previa en vivo. El documento de ejemplo también muestra toda la sintaxis de esta página.

Herramientas relacionadas

Listo cuando tú lo estés

Pega Markdown, suelta un archivo o abre una URL: la vista previa aparece al instante y todo se queda en tu dispositivo.

Abrir Markdown Viewer