Referencia

Hoja de referencia de Markdown

Todas las reglas de Markdown que necesitas, con la sintaxis a la izquierda y el resultado a la derecha. Cubre CommonMark y las extensiones de GitHub Flavored Markdown.

Encabezados

Seis niveles. Deja una línea en blanco antes del encabezado para que no se absorba en el párrafo anterior.

Sintaxis

Resultado

Encabezado de primer nivel

# Heading level 1

Heading level 1

Encabezado de sección

## Heading level 2

Heading level 2

Subsección

### Heading level 3

Heading level 3

Sintaxis alternativa para los niveles 1 y 2

Heading level 1
===============

Heading level 2
---------------

Heading level 1

Heading level 2

Énfasis

Funcionan tanto los asteriscos como los guiones bajos. Dentro de una palabra, los asteriscos son más seguros.

Sintaxis

Resultado

Negrita

**bold text**

bold text

Cursiva

*italic text*

italic text

Negrita y cursiva

***bold and italic***

bold and italic

Tachado (GFM)

~~struck through~~

~~struck through~~

Listas

Sangra dos espacios para anidar. Las listas numeradas se renumeran solas, así que puedes escribir 1. en todas.

Sintaxis

Resultado

Lista con viñetas

- First item
- Second item
- Third item

First item
Second item
Third item

Lista numerada

1. First item
1. Second item
1. Third item

First item
Second item
Third item

Lista anidada

- Parent item
  - Child item
    - Grandchild item

Parent item
- Child item
  - Grandchild item

Lista de tareas (GFM)

- [x] Finished task
- [ ] Open task

xFinished task
Open task

Enlaces e imágenes

Una imagen es un enlace con un signo de exclamación delante. El texto alternativo importa para la accesibilidad y el SEO.

Sintaxis

Resultado

Enlace en línea

[Markdown to Image](https://markdowntoimage.com)

Markdown to Image

Enlace con título emergente

[Markdown to Image](https://markdowntoimage.com "Convert Markdown")

Markdown to Image

Imagen

![A mountain at dusk](/photo.jpg)

A mountain at dusk

Enlace automático

<https://markdowntoimage.com>

https://markdowntoimage.com

Código

Escribe el lenguaje después de las comillas de apertura para obtener resaltado de sintaxis.

Sintaxis

Resultado

Código en línea

Run `npm install` first.

Run npm install first.

Bloque de código

```
plain code block
```

plain code block

Bloque con resaltado

```js
const total = items.length;
```

const total = items.length;

Citas

Las citas admiten cualquier otro Markdown dentro, incluidas listas y código.

Sintaxis

Resultado

Cita

> Everything should be made as
> simple as possible.

Everything should be made as simple as possible.

Cita anidada

> Outer quote
>
>> Inner quote

Outer quote
Inner quote

Tablas

Las columnas no necesitan estar alineadas en el código. Los dos puntos en la fila separadora definen la alineación.

Sintaxis

Resultado

Tabla básica

| Format | Size |
| --- | --- |
| PNG | 240 KB |
| PDF | 96 KB |

Format	Size
PNG	240 KB
PDF	96 KB

Alineación de columnas

| Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c |

Left	Center	Right
a	b	c

Otra sintaxis

Tres o más guiones crean una línea divisoria. Termina una línea con dos espacios para forzar un salto sin abrir un párrafo nuevo.

Sintaxis

Resultado

Línea divisoria

---

Salto de línea forzado

First line ends here.\
Second line starts here.

First line ends here.
Second line starts here.

Escapar un carácter especial

\*not italic\*

*not italic*

Nota al pie (GFM)

Text with a note.[^1]

[^1]: The note itself.

Text with a note.¹

Solución de Problemas

Soporte

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

GitHub Flavored Markdown (GFM) es un superconjunto de CommonMark. Añade tablas, listas de tareas, tachado, notas al pie y enlazado automático de URL. Todo lo marcado como GFM en esta página necesita un renderizador compatible con esas extensiones — la mayoría de los modernos lo son.

¿Por qué no se renderiza mi encabezado?

La causa más común es la falta de un espacio después de las almohadillas. Escribe # Encabezado, no #Encabezado. La segunda causa es no dejar una línea en blanco encima, lo que hace que algunos analizadores lo traten como parte del párrafo anterior.

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

Termina la línea con dos espacios, o usa una barra invertida al final. Un salto de línea simple se convierte en un espacio en la mayoría de los analizadores, y una línea en blanco abre un párrafo nuevo.

¿Cómo muestro un asterisco o un guion bajo literal?

Pon una barra invertida delante. Escribir \*texto\* se renderiza como *texto* en lugar de convertirlo en cursiva. Lo mismo sirve para comillas invertidas, almohadillas, corchetes y otros caracteres de Markdown.

¿Las tablas de Markdown necesitan columnas alineadas?

No. Las barras verticales no tienen que cuadrar en el código: el renderizador se encarga del diseño. Alinearlas solo hace más legible el archivo original. Lo que importa es la fila separadora bajo el encabezado.