Markdown.es Logo Markdown.es

¿Te es útil esta web? Apóyala sin coste: si compras en Amazon, hazlo a través de nuestro enlace de afiliado — el precio es el mismo para ti y nos ayuda a seguir.

Citas en Markdown: bloques de cita con el símbolo mayor que

Cómo crear bloques de cita en Markdown con el símbolo >, incluir varios párrafos, anidar citas dentro de otras y usar los avisos con formato de GitHub.

Los bloques de cita sirven para reproducir palabras ajenas, destacar un fragmento o dar contexto sin que se confunda con tu propio texto. Se crean con el símbolo mayor que > al principio de la línea.

Sintaxis básica

> Un país, una civilización se puede juzgar por la forma
> en que trata a sus animales. — Mahatma Gandhi

Un país, una civilización se puede juzgar por la forma en que trata a sus animales. — Mahatma Gandhi

El espacio después del > es opcional en la práctica, pero conviene ponerlo: mejora la legibilidad del original y algunos procesadores estrictos lo exigen.

Citas de varios párrafos

Para que la cita abarque varios párrafos, pon un > también en la línea en blanco que los separa. Si la dejas realmente vacía, la cita se corta ahí.

> Creo que los animales ven en el hombre un ser igual a ellos
> que ha perdido de forma peligrosa el sano intelecto animal.
>
> Es decir, que ven en él al animal irracional, al animal que
> ríe, al animal que llora. — Friedrich Nietzsche

Creo que los animales ven en el hombre un ser igual a ellos que ha perdido de forma peligrosa el sano intelecto animal.

Es decir, que ven en él al animal irracional, al animal que ríe, al animal que llora. — Friedrich Nietzsche

Fíjate en la línea con un > solitario en medio. Ese es el detalle que se olvida siempre.

La forma perezosa

Markdown admite que solo marques la primera línea de cada párrafo:

> Esta cita ocupa varias líneas
pero solo la primera lleva el símbolo.

Esta cita ocupa varias líneas pero solo la primera lleva el símbolo.

Funciona, y se llama lazy continuation. Pero no la recomiendo: en cuanto edites el texto o alguien lo revise en un diff, no queda nada claro dónde acaba la cita. Marca todas las líneas.

Citas anidadas

Concatena varios > para meter una cita dentro de otra:

> Esto es una cita normal.
>
> > Y esto es una cita dentro de la cita.
>
> Volvemos al primer nivel.

Esto es una cita normal.

Y esto es una cita dentro de la cita.

Volvemos al primer nivel.

Útil para reproducir hilos de correo o conversaciones encadenadas. Más de dos niveles suele volverse ilegible.

Otros elementos dentro de una cita

Un bloque de cita admite prácticamente cualquier otro elemento, siempre que cada línea lleve su >:

> ### Un encabezado dentro de la cita
>
> - Una lista
> - Con dos elementos
>
> Y hasta **negrita**, `código` y un [enlace](https://markdown.es).

Un encabezado dentro de la cita

  • Una lista
  • Con dos elementos

Y hasta negrita, código y un enlace.

También puedes incluir bloques de código, aunque hay que llevar cuidado con las vallas: todas las líneas, incluidas las de apertura y cierre, necesitan su >.

Avisos con formato (GitHub)

GitHub añadió en 2023 los alerts: bloques de cita especiales que se pintan con color e icono según el tipo. Se declaran con una primera línea entre corchetes:

> [!NOTE]
> Información útil que el lector debería conocer.

> [!TIP]
> Un consejo para hacerlo mejor.

> [!IMPORTANT]
> Información imprescindible para conseguir el objetivo.

> [!WARNING]
> Contenido crítico que requiere atención inmediata.

> [!CAUTION]
> Posibles consecuencias negativas de una acción.

⚠️ Solo funcionan en GitHub y en algunos procesadores que lo han copiado (Obsidian tiene su propia sintaxis parecida con > [!info]). En el resto se ven como una cita normal con el texto [!NOTE] literal encima. No es catastrófico, pero queda feo: úsalos solo si escribes específicamente para GitHub.

Cuándo usar una cita y cuándo no

Los bloques de cita se usan mucho como “caja destacada” genérica porque visualmente resaltan. Funciona, pero conviene saber que > genera un <blockquote> en HTML, y esa etiqueta tiene un significado semántico concreto: contenido citado de otra fuente.

Para destacar un aviso propio que no es una cita, lo semánticamente correcto sería una caja HTML con su propio estilo. En la práctica, casi todo el mundo usa el blockquote igualmente y no pasa nada grave; solo tenlo presente si te importa la accesibilidad.

Errores frecuentes

La línea en blanco sin >. Corta la cita en dos bloques separados. Es el fallo más común con diferencia.

Olvidar el espacio en citas anidadas. Escribe > > y no >>. Aunque muchos procesadores toleran la segunda forma, la primera es la correcta y funciona en todos.

Sangrar la cita. Un > precedido de cuatro espacios se convierte en un bloque de código, no en una cita.

Compatibilidad

Las citas básicas y anidadas funcionan en todas partes: Markdown original, CommonMark, GFM, Discord, Reddit, Obsidian, Notion. Los avisos con formato [!NOTE] son la única parte no portable.

Pruébalo

Comprueba dónde se corta tu cita en el previsualizador de Markdown, o mira las etiquetas <blockquote> anidadas que se generan con el conversor a HTML.