Guía de sintaxis básica de Markdown
La sintaxis básica de Markdown consiste en los 11 elementos de formato que John Gruber definió en el documento de diseño original de 2004, y casi todas las aplicaciones de Markdown en 2026 siguen soportando 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 usa signos de puntuación que ya tienes en el teclado de tu ordenador, y cada uno se convierte en una etiqueta HTML concreta. Existen pequeñas diferencias entre procesadores, así que esta guía de sintaxis Markdown señala las opciones que se renderizan igual en todas partes. Todos los ejemplos de abajo se pegan directamente en un editor de Markdown con vista previa en directo, y el resultado renderizado aparece mientras escribes.
Encabezados
Un encabezado empieza con 1 a 6 almohadillas (#) seguidas de un espacio, y el número de almohadillas marca 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 convierte en la etiqueta HTML correspondiente, de modo que # Page Title se renderiza como un elemento h1 y ###### Fine Print como un h6. Markdown también ofrece una sintaxis alternativa para los 2 niveles superiores. Coloca cualquier cantidad de signos igual en la línea situada debajo del texto para un H1, o cualquier cantidad de guiones para un H2. La forma con # se conoce como estilo ATX; la forma subrayada se conoce como 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 mantén 1 espacio entre las almohadillas y el texto, para que los encabezados Markdown se rendericen correctamente en cualquier aplicación.
Párrafos
Un párrafo es una o más líneas consecutivas de texto con una línea en blanco por encima y por debajo, y no necesita ningún marcador.
The first paragraph ends here.
A blank line above this sentence starts a second paragraph.
El renderizador envuelve cada bloque en una etiqueta p, así que los 2 bloques de arriba se convierten en 2 párrafos HTML separados. Los retornos simples dentro de un bloque se funden en texto continuo, lo que significa que puedes cortar las líneas del fichero fuente a 80 caracteres y la salida sigue siendo un único párrafo sin cortes.
Buena práctica: mantén cada párrafo pegado al margen izquierdo, porque 4 o más espacios iniciales convierten un párrafo en un bloque de código.
Saltos de línea
Un salto de línea dentro de un párrafo requiere 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.
Ambos métodos renderizan un elemento br, así que la segunda línea queda justo debajo de la primera sin separación de párrafo. Un retorno simple sin nada detrás fusiona las 2 líneas en una sola. CommonMark también acepta una barra invertida final como salto, pero los procesadores antiguos la ignoran, así que las 2 opciones portables siguen siendo los espacios finales y la etiqueta <br>.
Buena práctica: elige la etiqueta <br> cuando el salto tenga que sobrevivir al copiar y pegar y a la revisión de código, ya que los espacios finales quedan invisibles en la mayoría de los editores.
Énfasis
La negrita lleva 2 asteriscos a cada lado, la cursiva lleva 1 y la negrita cursiva lleva 3; los guiones bajos sirven como alternativa equivalente 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 renderizador convierte los marcadores en etiquetas strong y em: **bold** se convierte en <strong>bold</strong>, *italic* se convierte en <em>italic</em>, y el marcador triple anida una etiqueta dentro de la otra. El énfasis también funciona dentro de una palabra, así que un*believ*able pone en cursiva solo las 6 letras centrales.
Buena práctica: para la negrita Markdown en mitad de una palabra usa asteriscos en lugar de guiones bajos, porque todos los procesadores principales tratan igual los asteriscos interiores mientras que los guiones bajos interiores varían.
Citas en bloque
Una cita en bloque empieza con un signo mayor que (>) al inicio 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.
La salida es un elemento blockquote, y el marcador doble anida una segunda cita dentro de la primera. Las citas admiten otros elementos de Markdown. Un encabezado, una lista o un texto en negrita se renderizan con normalidad dentro de la cita cuando cada una de sus líneas empieza con el marcador >, algo muy útil para correos citados y pasajes con estructura propia.
Buena práctica: rodea cada cita en bloque con líneas en blanco para que cada procesador detecte exactamente dónde empieza y dónde termina la cita.
Listas
Una lista ordenada coloca un número y un punto antes de cada elemento, y una lista desordenada coloca un guion, un asterisco o un signo 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 renderizan como elementos ol y cuentan desde el primer número que escribas, así que una lista escrita como 1, 8, 3 sigue mostrando 1, 2, 3. Las listas desordenadas se renderizan como elementos ul con cualquiera de los 3 delimitadores. Una sangría de 4 espacios o 1 tabulador anida una sublista, y la misma sangría mantiene otros elementos dentro de un elemento de lista: un párrafo o una cita necesitan 4 espacios, mientras que 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 termina los números de las listas ordenadas con punto en lugar de paréntesis, ya que la forma con punto funciona en todas las aplicaciones de Markdown.
Código
El código en línea va entre acentos graves simples, y un bloque de código es cualquier grupo de líneas con una sangría mínima de 4 espacios o 1 tabulador.
Type `git status` to check the working tree.
<html>
<head></head>
</html>
El par de acentos graves renderiza un elemento code con fuente monoespaciada, y el bloque sangrado se renderiza dentro de etiquetas pre y code con todos los espacios conservados. Un fragmento que a su vez contiene un acento grave necesita acentos graves dobles alrededor, de modo que the outer pair displays `code` literally. Los bloques de código delimitados con triple acento grave pertenecen a la sintaxis extendida; la sangría de 4 espacios es el método original.
Buena práctica: envuelve los acentos graves literales entre acentos graves dobles para que el carácter interior se imprima en lugar 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 su propia línea.
***
---
___
Las 3 versiones renderizan un elemento hr idéntico, un divisor a todo el ancho. El carácter puede repetirse más allá de 3 sin cambio alguno en el resultado, así que una línea de 20 guiones produce la misma línea que una de 3. Los escritores usan estas líneas para marcar cambios de escena y límites de sección donde un encabezado resultaría demasiado pesado.
Buena práctica: deja una línea en blanco por encima y por debajo de cada línea horizontal, porque una línea solo de guiones colocada justo debajo de un texto convierte ese texto en un encabezado H2.
Enlaces
Un enlace en línea envuelve el texto del enlace entre corchetes y lo sigue inmediatamente 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 renderizan un elemento a, y el texto del título aparece como descripción emergente al pasar el ratón. Los enlaces de estilo referencia separan la URL de la frase: la etiqueta [1] apunta a una definición que puede colocarse en cualquier parte del fichero, así que un párrafo lleno de URL largas se mantiene legible en el código fuente. Los corchetes angulares convierten una URL o una dirección de correo sin más en un enlace en el que se puede hacer clic, sin texto adicional. Los enlaces también aceptan formato: los asteriscos alrededor de toda la construcción ponen el enlace en negrita y los acentos graves dentro de los corchetes lo renderizan como código.
Buena práctica: codifica cualquier espacio dentro de una URL como %20 para que la dirección completa sobreviva en todos los procesadores.
Imágenes
Una imagen usa un signo de exclamación, luego el texto alternativo entre corchetes y luego la ruta o URL de la imagen entre paréntesis.
[](https://example.com/report)
La primera línea renderiza un elemento img con el texto alternativo como etiqueta de accesibilidad y el título entrecomillado como texto al pasar el cursor. La sintaxis coincide con la de un enlace con 1 carácter extra delante. La segunda línea anida toda la construcción de la imagen dentro de un enlace, así que al hacer clic en la imagen se abre la URL de destino.
Buena práctica: escribe un texto alternativo que describa el contenido de la imagen, porque los lectores de pantalla y los buscadores lo leen en lugar de la imagen.
Escape de caracteres
Una barra invertida () colocada antes de un carácter de formato muestra ese carácter de forma literal en lugar de activar su función en Markdown.
\* This line shows a literal asterisk, not a bullet point.
1968\. The escaped period stops this year from starting an ordered list.
La barra invertida nunca aparece en la salida; solo se imprime el carácter que va detrás. Markdown acepta el escape con barra invertida para 12 caracteres: barra invertida, acento grave, asterisco, guion bajo, llaves, corchetes, paréntesis, almohadilla, signo más, signo menos, punto y signo de exclamación. El segundo ejemplo de arriba resuelve una trampa habitual, ya que cualquier línea que empiece con un número y un punto se convierte en un elemento de lista si no lleva el escape.
Buena práctica: escapa solo los caracteres de esa lista de 12, porque una barra invertida delante de cualquier otro carácter se imprime como una barra 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 todas las aplicaciones de Markdown lo soportan al completo. Los 11 elementos se comportan de forma consistente entre procesadores, lo que convierte al conjunto básico en la opción más segura para documentos que viajan entre plataformas.
¿Cuántos niveles de encabezado soporta Markdown?
Markdown soporta 6 niveles de encabezado, escritos con 1 a 6 almohadillas, y se corresponden directamente con las etiquetas HTML h1 a h6. La sintaxis alternativa de subrayado cubre solo los 2 niveles superiores: signos igual para el H1 y guiones para el H2.
¿Cómo añado un salto de línea sin empezar un párrafo nuevo?
Termina la línea con 2 espacios finales o con la etiqueta HTML <br>. Ambos renderizan un elemento br dentro del párrafo actual. Una línea en blanco tiene un efecto distinto: cierra el párrafo y abre uno nuevo.
¿Basta con la sintaxis básica o necesito la extendida?
La sintaxis básica cubre los documentos estándar, mientras que la extendida añade tablas, bloques de código delimitados, notas al pie y otros elementos de especificaciones posteriores como GFM. Empieza con el conjunto básico para lograr la máxima compatibilidad y añade elementos extendidos cuando sepas que la plataforma de destino los soporta.