Sintaxis básica de Markdown: guía completa
La sintaxis básica de Markdown está formada por los 11 elementos de formato que John Gruber definió en el documento de diseño original de 2004, y casi cualquier aplicación de Markdown en 2026 todavía soporta el conjunto completo. Los 11 elementos son: encabezados, párrafos, saltos de línea, énfasis, citas en bloque, listas, código, líneas horizontales, enlaces, imágenes y escape de caracteres. Cada elemento se escribe con signos que ya están en el teclado de tu computadora, y cada uno se transforma en una etiqueta HTML específica. Hay pequeñas diferencias entre procesadores, por eso esta guía de sintaxis Markdown te marca las opciones que se ven igual en todos lados. Todos los ejemplos de esta página se pegan tal cual en un editor de Markdown con vista previa en vivo, y el resultado aparece conforme escribes.
Encabezados
Un encabezado comienza con 1 a 6 signos de numeral (#), también llamados gato, seguidos de un espacio, y la cantidad de signos define el nivel de H1 a H6.
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6
Cada línea se transforma en la etiqueta HTML correspondiente: # Page Title se despliega como un elemento h1 y ###### Fine Print como un h6. Markdown también tiene una sintaxis alterna para los 2 niveles superiores. Coloca cualquier cantidad de signos de igual en la línea de abajo del texto para un H1, o cualquier cantidad de guiones para un H2. La forma con # se llama estilo ATX; la forma con subrayado se llama estilo Setext.
Heading level 1
===============
Heading level 2
---------------
Buena práctica: deja una línea en blanco antes y después de cada encabezado y conserva 1 espacio entre los signos de numeral y el texto, así los encabezados Markdown se muestran bien en cualquier aplicación.
Párrafos
Un párrafo son una o varias líneas seguidas de texto con una línea en blanco arriba y abajo, y no necesita ningún marcador.
The first paragraph ends here.
A blank line above this sentence starts a second paragraph.
El procesador envuelve cada bloque en una etiqueta p, por lo que los 2 bloques de arriba se convierten en 2 párrafos HTML distintos. Los saltos sencillos dentro de un bloque se unen en texto corrido, así que puedes cortar las líneas del archivo fuente a 80 caracteres y la salida queda como un solo párrafo continuo.
Buena práctica: mantén cada párrafo pegado al margen izquierdo, porque 4 o más espacios al inicio convierten el párrafo en un bloque de código.
Saltos de línea
Para un salto de línea dentro de un párrafo necesitas 2 o más espacios al final de la línea, o la etiqueta HTML <br>.
This line ends with 2 trailing spaces.
This line appears directly below it.
This line ends with a br tag.<br>
This line also sits inside the same paragraph.
Los 2 métodos generan un elemento br, así que la segunda línea queda justo debajo de la primera sin espacio de párrafo. Un salto sencillo sin nada después une las 2 líneas en una sola. CommonMark también acepta una diagonal invertida al final como salto, pero los procesadores viejos la ignoran, por eso las 2 opciones portables siguen siendo los espacios finales y la etiqueta <br>.
Buena práctica: usa la etiqueta <br> cuando el salto deba sobrevivir al copiado y pegado y a la revisión de código, porque los espacios finales no se ven en la mayoría de los editores.
Énfasis
Las negritas llevan 2 asteriscos de cada lado, las cursivas llevan 1 y las negritas con cursivas llevan 3; los guiones bajos son una alternativa igual de válida alrededor de palabras completas.
This word is **bold** and so is this __word__.
This word is *italic* and so is this _word_.
This phrase is ***bold and italic***.
El procesador convierte los marcadores en etiquetas strong y em: **bold** se vuelve <strong>bold</strong>, *italic* se vuelve <em>italic</em>, y el marcador triple anida una etiqueta dentro de la otra. El énfasis también funciona dentro de una palabra: un*believ*able pone en cursiva únicamente las 6 letras de en medio.
Buena práctica: para poner negrita Markdown a media palabra, quédate con los asteriscos en lugar de los guiones bajos, porque todos los procesadores importantes manejan igual los asteriscos interiores y con los guiones bajos interiores cada uno hace algo distinto.
Citas en bloque
Una cita en bloque inicia con un signo de mayor que (>) al principio de la línea, y cada línea citada lleva su propio marcador.
> A single-paragraph quote needs 1 marker per line.
>
> A marked blank line continues the quote into a second paragraph.
>
>> Two markers push this paragraph 1 level deeper as a nested quote.
El resultado es un elemento blockquote, y el marcador doble mete una segunda cita dentro de la primera. Las citas aceptan otros elementos de Markdown: un encabezado, una lista o un texto en negritas se muestran normal dentro de la cita cuando cada una de sus líneas comienza con el marcador >, lo cual funciona muy bien para correos citados y fragmentos con estructura propia.
Buena práctica: encierra cada cita en bloque entre líneas en blanco para que todos los procesadores detecten con exactitud dónde empieza y dónde termina.
Listas
Una lista ordenada pone un número y un punto antes de cada elemento, y una lista sin ordenar pone un guion, un asterisco o un signo de más antes de cada elemento.
1. First step
2. Second step
3. Third step
1. Indented sub-step
- Bullet item
- Bullet item
- Nested bullet
Las listas Markdown ordenadas se despliegan como elementos ol y cuentan desde el primer número que escribas, de modo que una lista capturada como 1, 8, 3 de todos modos muestra 1, 2, 3. Las listas sin ordenar se despliegan como elementos ul con cualquiera de los 3 delimitadores. Una sangría de 4 espacios o 1 tabulador anida una sublista, y esa misma sangría mantiene otros elementos dentro del elemento de lista: un párrafo o una cita necesitan 4 espacios, y un bloque de código dentro de una lista necesita 8 espacios porque la sangría estándar de 4 espacios del código se suma a la sangría de la lista.
Buena práctica: usa 1 solo estilo de delimitador por lista y cierra los números de las listas ordenadas con punto y no con paréntesis, porque la forma con punto funciona en todas las aplicaciones de Markdown.
Código
El código en línea va entre comillas invertidas (backticks) sencillas, y un bloque de código es cualquier grupo de líneas con sangría de al menos 4 espacios o 1 tabulador.
Type `git status` to check the working tree.
<html>
<head></head>
</html>
El par de backticks genera un elemento code con tipografía monoespaciada, y el bloque con sangría se muestra dentro de etiquetas pre y code con todos los espacios intactos. Un fragmento que trae un backtick adentro necesita backticks dobles alrededor, así the outer pair displays `code` literally. Los bloques de código cercados con triple backtick son parte de la sintaxis extendida; la sangría de 4 espacios es el método original.
Buena práctica: envuelve los backticks literales entre backticks dobles para que el carácter interno se imprima en vez de cerrar el fragmento de código antes de tiempo.
Líneas horizontales
Una línea horizontal requiere 3 o más asteriscos, guiones o guiones bajos solos en una línea propia.
***
---
___
Las 3 versiones generan un elemento hr idéntico, un divisor de todo el ancho. El carácter puede repetirse más allá de 3 sin cambiar el resultado: una línea de 20 guiones produce el mismo divisor que una de 3. Este recurso sirve para marcar cambios de escena y límites de sección donde un encabezado se sentiría demasiado pesado.
Buena práctica: deja una línea en blanco arriba y abajo de cada línea horizontal, porque una línea de puros guiones pegada debajo de un texto convierte ese texto en un encabezado H2.
Enlaces
Un enlace en línea encierra el texto del enlace entre corchetes y lo sigue de inmediato con la URL entre paréntesis, más un título opcional entre comillas.
Read the [original spec](https://daringfireball.net/projects/markdown/ "Gruber's 2004 spec").
Reference style keeps prose clean: read the [original spec][1].
[1]: https://daringfireball.net/projects/markdown/
Bare addresses work in angle brackets: <https://example.com> and <mail@example.com>
Todas las formas generan un elemento a, y el texto del título aparece como globo informativo al pasar el mouse. Los enlaces de referencia separan la URL de la oración: la etiqueta [1] apunta a una definición que puede ir en cualquier parte del archivo, así un párrafo lleno de URL largas se mantiene legible en el texto fuente. Los corchetes angulares convierten una URL o un correo tal cual en un enlace al que puedes dar clic, sin texto extra. Los enlaces también aceptan formato: los asteriscos alrededor de toda la construcción ponen el enlace en negritas y los backticks dentro de los corchetes lo muestran como código.
Buena práctica: codifica cualquier espacio dentro de una URL como %20 para que la dirección completa llegue entera a todos los procesadores.
Imágenes
Una imagen lleva un signo de admiración, luego el texto alternativo entre corchetes y después la ruta o URL de la imagen entre paréntesis.
[](https://example.com/report)
La primera línea genera un elemento img con el texto alternativo como etiqueta de accesibilidad y el título entre comillas como texto al pasar el cursor. La sintaxis es igual a la de un enlace con 1 carácter extra al frente. La segunda línea mete toda la construcción de la imagen dentro de un enlace, así que al dar clic en la imagen se abre la URL de destino.
Buena práctica: redacta un texto alternativo que describa lo que muestra la imagen, porque los lectores de pantalla y los buscadores lo leen en lugar de la imagen.
Escape de caracteres
Una diagonal invertida () colocada antes de un carácter de formato hace que ese carácter se muestre de manera literal en lugar de activar su función de Markdown.
\* This line shows a literal asterisk, not a bullet point.
1968\. The escaped period stops this year from starting an ordered list.
La diagonal invertida nunca aparece en el resultado; solo se imprime el carácter que la sigue. Markdown acepta escape con diagonal invertida para 12 caracteres: diagonal invertida, backtick, asterisco, guion bajo, llaves, corchetes, paréntesis, signo de numeral, signo de más, signo de menos, punto y signo de admiración. El segundo ejemplo de arriba resuelve una trampa común, porque cualquier línea que empiece con un número y un punto se vuelve elemento de lista si no lleva el escape.
Buena práctica: escapa solo los caracteres de esa lista de 12, porque una diagonal invertida antes de cualquier otro carácter se imprime como una diagonal invertida visible.
Preguntas frecuentes
¿Qué es la sintaxis básica de Markdown?
La sintaxis básica es el conjunto de 11 elementos del documento de diseño de Markdown que John Gruber publicó en 2004, y casi cualquier aplicación de Markdown soporta el conjunto completo. Los 11 elementos se comportan igual entre procesadores, y eso hace del conjunto básico la opción más segura para documentos que se mueven entre plataformas.
¿Cuántos niveles de encabezado soporta Markdown?
Markdown soporta 6 niveles de encabezado, escritos con 1 a 6 signos de numeral, y corresponden directo a las etiquetas HTML h1 a h6. La sintaxis alterna con subrayado solo cubre los 2 niveles de arriba: signos de igual para el H1 y guiones para el H2.
¿Cómo agrego un salto de línea sin comenzar un párrafo nuevo?
Termina la línea con 2 espacios finales o con la etiqueta HTML <br>. Los 2 generan un elemento br dentro del mismo párrafo. Una línea en blanco hace otra cosa: cierra el párrafo y abre uno nuevo.
¿La sintaxis básica es suficiente o necesito la extendida?
La sintaxis básica cubre los documentos estándar, mientras que la extendida agrega tablas, bloques de código cercados, notas al pie y otros elementos de especificaciones posteriores como GFM. Comienza con el conjunto básico para tener la máxima compatibilidad y agrega elementos extendidos cuando confirmes que la plataforma de destino los soporta.