Citas en Markdown Explicadas: La Guía Completa

Una cita en bloque es una forma de destacar texto que proviene de otra fuente o que necesita más énfasis, como una cita, una nota o un ejemplo. En Markdown, las citas en bloque son fáciles de crear con un símbolo simple, por lo que resultan útiles para escritores, bloggers, estudiantes y cualquier persona que publique contenido online. Esta guía te mostrará qué son las citas en bloque y cómo usarlas correctamente en Markdown.

Respuesta Rápida: ¿Cómo Se Crea una Cita en Markdown?

Para crear una cita en markdown, añade un signo de mayor que (>) seguido de un espacio al inicio de cualquier línea. La línea completa se convierte en un bloque de cita.

> Esto es una cita.

Se renderiza como:

Esto es una cita.

Esa es toda la sintaxis básica. El resto de esta guía cubre citas multilínea, anidamiento, alertas de GitHub, callouts de Obsidian, estilos, compatibilidad entre plataformas y todos los demás casos de uso que encontrarás. Para una referencia más amplia, consulta nuestra hoja de referencia completa de markdown.

---

Sintaxis Básica de Citas en Markdown

Toda cita en markdown comienza con > al inicio de una línea.

> Esta es una cita de una sola línea.

Se renderiza como:

Esta es una cita de una sola línea.

El espacio después de > es opcional pero recomendado. Ambas formas funcionan de manera idéntica en la mayoría de los parsers:

> Con un espacio
>Sin un espacio

Para máxima compatibilidad, especialmente en parsers más estrictos de CommonMark, incluye siempre el espacio.

¿Por qué el carácter >? Markdown tomó prestada su sintaxis de citas de las convenciones del correo electrónico. Cuando respondes a un email, el texto citado suele llevar el prefijo >. Gruber mantuvo la convención porque ya era familiar para cualquiera que hubiera usado el correo electrónico desde los años 80.

---

Citas Multilínea en Markdown

Múltiples Líneas en el Mismo Párrafo

Añade > al inicio de cada línea:

> Esta es la primera línea de la cita.
> Esta es la segunda línea.
> Esta es la tercera línea.

Se renderiza como un solo párrafo:

Esta es la primera línea de la cita. Esta es la segunda línea. Esta es la tercera línea.

Continuación Perezosa (No Recomendada)

Algunos parsers permiten omitir el > en las líneas de continuación:

> Esta es la primera línea.
Esta es la segunda línea (estilo perezoso).

Esto funciona en CommonMark y GitHub Flavored Markdown, pero algunos parsers fallan con esto. Siempre pon el prefijo > en cada línea para garantizar la compatibilidad.

Citas con Múltiples Párrafos

Para varios párrafos dentro de una misma cita, sepáralos con una línea que contenga solo >:

> Este es el primer párrafo de la cita.
>
> Este es el segundo párrafo. Observa la línea en blanco con `>` arriba.
>
> Y este es un tercer párrafo.

Se renderiza como:

Este es el primer párrafo de la cita.

Este es el segundo párrafo. Observa la línea en blanco con > arriba.

Y este es un tercer párrafo.

Regla fundamental: La línea en blanco entre párrafos debe tener igualmente un carácter >. Sin él, la cita termina y comienza una nueva, lo cual normalmente no es lo que quieres.

---

Citas Anidadas en Markdown

Apila caracteres > para anidar citas dentro de otras:

> Esta es la cita de primer nivel.
>
> > Esta es una cita anidada dentro de la primera.
> >
> > > Y esta está anidada tres niveles de profundidad.
>
> De vuelta al primer nivel.

Se renderiza como:

Esta es la cita de primer nivel.

Esta es una cita anidada dentro de la primera.

Y esta está anidada tres niveles de profundidad.

De vuelta al primer nivel.

El anidamiento es común en cadenas de respuesta estilo email, donde cada nivel de > representa otra ronda de citado. En la práctica, ir más allá de dos o tres niveles se vuelve difícil de leer, así que considera reestructurar el contenido antes de anidar cuatro niveles.

---

Formato Dentro de Citas en Markdown

Las citas pueden contener la mayoría de los demás elementos de markdown. Coloca cada elemento en su propia línea, siempre con el prefijo >.

Formato de Texto

> Puedes usar **negrita**, *cursiva*, ***negrita cursiva***,
> ~~tachado~~ y `código en línea` dentro de las citas.

Se renderiza como:

Puedes usar negrita, cursiva, negrita cursiva, tachado y código en línea dentro de las citas.

Encabezados

> ### Este es un encabezado dentro de una cita
>
> Y este es texto normal debajo.

Se renderiza como:

### Este es un encabezado dentro de una cita

Y este es texto normal debajo.

Listas

Funcionan tanto las listas ordenadas como las no ordenadas:

> **Revisión Trimestral:**
>
> - Los ingresos crecieron un 23%
> - La plantilla aumentó en 12 personas
> - La rotación de clientes bajó al 3%
>
> *Todas las métricas muestran una tendencia positiva.*

Se renderiza como:

Revisión Trimestral:

• Los ingresos crecieron un 23%
• La plantilla aumentó en 12 personas
• La rotación de clientes bajó al 3%

Todas las métricas muestran una tendencia positiva.

Bloques de Código

Los bloques de código delimitados funcionan dentro de las citas, pero cada línea necesita el prefijo >:

> Ejecuta el siguiente comando para instalar:
>
> ```bash
> npm install markdown-it
> ```
>
> Luego reinicia tu aplicación.

Enlaces e Imágenes

> Para más información, visita [nuestra documentación](https://example.com).
>
> ![Logo](https://example.com/logo.png)

Lo Que No Funciona de Forma Fiable

• Tablas dentro de citas funcionan en GitHub Flavored Markdown pero fallan en parsers más estrictos. Prueba antes de depender de ellas.
• Líneas horizontales dentro de citas (---) son ambiguas y se renderizan de forma inconsistente.
• Elementos HTML de bloque dentro de citas se comportan de manera impredecible entre parsers.

---

Alertas de GitHub (Notas, Advertencias, Consejos)

GitHub Flavored Markdown (GFM) extiende la sintaxis de citas con cinco tipos especiales de alertas que se renderizan con colores e iconos distintos en GitHub, GitHub Issues, READMEs y pull requests.

Sintaxis

> [!NOTE]
> Información útil que los usuarios deberían conocer, incluso al leer por encima.

> [!TIP]
> Consejos útiles para hacer las cosas mejor o más fácilmente.

> [!IMPORTANT]
> Información clave que los usuarios necesitan saber para lograr su objetivo.

> [!WARNING]
> Información urgente que necesita atención inmediata para evitar problemas.

> [!CAUTION]
> Advierte sobre riesgos o consecuencias negativas de ciertas acciones.

Reglas para las Alertas de GitHub

• El tipo de alerta ([!NOTE], [!TIP], etc.) debe estar en su propia línea al inicio de la cita.
• Los tipos de alerta distinguen entre mayúsculas y minúsculas: [!note] no funcionará.
• La alerta se aplica a toda la cita que le sigue.
• Solo un tipo de alerta por cita. No se admite mezclar tipos.

Cuándo Usar Cada Tipo

Alerta	Usar para
[!NOTE]	Contexto útil que no es crítico pero ayuda al lector
[!TIP]	Consejo opcional que facilita o mejora algo
[!IMPORTANT]	Información que el lector debe conocer para tener éxito
[!WARNING]	Algo que podría salir mal si se ignora
[!CAUTION]	Riesgos graves, pérdida de datos, problemas de seguridad, acciones irreversibles

Las alertas de GitHub funcionan en READMEs de repositorios, páginas wiki, issues, pull requests y discusiones. No se renderizan como alertas fuera de GitHub; en otros lugares se muestran como citas normales con el texto [!NOTE] visible como texto plano.

---

Callouts de Obsidian

Obsidian usa una sintaxis similar a las alertas de GitHub pero con muchas más opciones. La sintaxis es > [!tipo] seguida del contenido:

> [!note] Título personalizado aquí
> Este es un callout de nota con un título personalizado.

> [!warning]
> Este es un callout de advertencia.

> [!tip] Consejo profesional
> Los callouts pueden tener títulos personalizados para dar contexto adicional.

Tipos de Callouts en Obsidian

Obsidian admite más de una docena de tipos de callouts, cada uno con colores e iconos distintos:

• note, info, abstract, summary, tldr
• tip, hint, important
• success, check, done
• question, help, faq
• warning, caution, attention
• failure, fail, missing
• danger, error
• bug
• example
• quote, cite

Callouts Plegables

Añade un + o - después del tipo para hacer que los callouts sean plegables:

> [!note]+ Haz clic para expandir (empieza abierto)
> Contenido oculto detrás de un interruptor.

> [!warning]- Haz clic para expandir (empieza cerrado)
> Colapsado por defecto.

Callouts Anidados

Los callouts se pueden anidar igual que las citas normales:

> [!note] Callout exterior
> Este es el contenido exterior.
>
> > [!tip] Callout interior
> > Este está anidado dentro.

Los callouts de Obsidian son la razón por la que muchos usuarios de markdown prefieren Obsidian para tomar notas: convierten citas simples en cuadros de información enriquecidos y con estilo.

---

Cuándo Usar Citas

Las citas son versátiles. Aquí tienes las cinco situaciones más comunes en las que las usarás, con ejemplos para ayudarte a entenderlas.

1. Citar a Otra Persona

El propósito original. Atribuye citas a su fuente con una línea de atribución:

> La mejor manera de predecir el futuro es inventarlo.
>
> Alan Kay

Se renderiza como:

La mejor manera de predecir el futuro es inventarlo.

Alan Kay

Estilo académico con citación formal:

> Markdown es una herramienta de conversión de texto a HTML para escritores web.
> Markdown te permite escribir usando un formato de texto plano fácil de leer
> y fácil de escribir, para luego convertirlo en XHTML (o HTML) estructuralmente válido.
>
> John Gruber, [Daring Fireball](https://daringfireball.net/projects/markdown/)

2. Citas Destacadas en Contenido Extenso

Extrae una frase memorable del cuerpo del texto para atraer la atención visual:

El equipo lanzó la funcionalidad en tiempo récord. La moral se disparó. Los ingresos siguieron.

> En tres meses, pasamos de cero usuarios a cuarenta mil.

Lo que marcó la diferencia no fue el código, fue el momento oportuno.

3. Notas y Avisos

Antes de que existieran las alertas de GitHub, la gente usaba citas con etiquetas en negrita para crear avisos:

> **Nota:** Esta funcionalidad requiere Node.js 18 o superior.

> **Advertencia:** Ejecutar este comando eliminará todos los datos de la base de datos.

> **Consejo:** Puedes saltarte el paso de configuración usando la bandera `--auto`.

Todavía se usa ampliamente en plataformas que no soportan alertas de GitHub.

4. Respuestas y Citado Estilo Email

En discusiones, issues y pull requests:

> ¿Deberíamos usar PostgreSQL o MySQL para esto?

PostgreSQL. Mejor soporte de JSON y un sistema de tipos más robusto.

5. Citaciones con Fuentes

Para escritura académica, periodística o técnica:

> El 78% de los desarrolladores reportan usar markdown a diario.
>
> Un artículo interesante sobre markdown, 2025

---

Estilizar Citas con CSS

El markdown puro no tiene opciones de estilo. Las citas se renderizan como la plataforma decida. La mayoría de los renderizadores usan un borde izquierdo, texto gris y algo de relleno por defecto.

Estilos Personalizados en Tu Propio Sitio

Si publicas markdown en un sitio que controlas (Jekyll, Hugo, Ghost, Next.js y similares), sobrescribe el CSS de <blockquote>:

blockquote {
  border-left: 4px solid #3498db;
  padding: 1em 1.5em;
  margin: 1.5em 0;
  background: #f8f9fa;
  font-style: italic;
  color: #555;
}

blockquote p:last-child {
  margin-bottom: 0;
}

HTML en Línea como Alternativa

Cuando necesitas un estilo específico de cita dentro de markdown y la plataforma permite HTML sin procesar:

<blockquote style="border-left: 4px solid #e74c3c; padding-left: 1em; color: #666;">
  Esta es una cita con estilo personalizado.
</blockquote>

Esto funciona en GitHub, la mayoría de generadores de sitios estáticos y Ghost. No funciona en Reddit, Discord ni Slack (que eliminan el HTML en línea).

---

Compatibilidad entre Plataformas

Las citas son una de las funcionalidades de markdown con mayor soporte universal. Funcionan en casi todas partes, pero con variaciones específicas por plataforma que vale la pena conocer.

| Plataforma     | Citas | Anidadas | Alertas GitHub | Callouts    |
| -------------- | :---: | :------: | :------------: | :---------- |
| GitHub (GFM)   | Sí    | Sí       | Sí             | No          |
| GitLab         | Sí    | Sí       | Parcial        | No          |
| Bitbucket      | Sí    | Sí       | No             | No          |
| Reddit         | Sí    | Sí       | No             | No          |
| Discord        | Sí    | No       | No             | No          |
| Slack          | Sí    | No       | No             | No          |
| Notion         | Sí    | Sí       | No             | No          |
| Obsidian       | Sí    | Sí       | Como callout   | Sí          |
| Stack Overflow | Sí    | Sí       | No             | No          |
| Jekyll / Hugo  | Sí    | Sí       | Vía plugin     | No          |

Notas Específicas por Plataforma

Discord soporta citas de una y varias líneas pero no soporta anidamiento. Usa > para una sola línea o >>> al inicio para una cita multilínea que continúa hasta el final del mensaje.

Slack renderiza > como una cita pero no soporta anidamiento. Las citas multilínea requieren > en cada línea.

Reddit requiere una línea en blanco antes de cualquier cita para que se renderice. Esta es la razón más común por la que las citas fallan en Reddit.

Notion convierte automáticamente la entrada > en su propio bloque de Cita. Las citas anidadas requieren arrastrar bloques unos dentro de otros.

Para más peculiaridades de cada plataforma, consulta nuestra guía de compatibilidad completa en la hoja de referencia principal.

---

Errores Comunes y Soluciones

1. La cita no se renderiza

Causa: Falta una línea en blanco antes o después de la cita.

Incorrecto:

Aquí hay texto normal.
> Esto debería ser una cita.
Más texto.

Correcto:

Aquí hay texto normal.

> Esto debería ser una cita.

Más texto.

La mayoría de los parsers son tolerantes con esto, pero los más estrictos (incluyendo Reddit) requieren líneas en blanco a ambos lados.

2. La cita de múltiples párrafos se divide en dos

Causa: La línea en blanco entre párrafos no tiene un >.

Incorrecto:

> Primer párrafo.

> Segundo párrafo (esto se convierte en una cita separada).

Correcto:

> Primer párrafo.
>
> Segundo párrafo (ahora forma parte de la misma cita).

La línea separadora en blanco debe contener igualmente >.

3. La alerta de GitHub se renderiza como una cita normal

Causa: La etiqueta de alerta está en la línea incorrecta, tiene mayúsculas/minúsculas incorrectas o tiene espacios extra.

Incorrecto:

> [!note]
> Esto es una nota.

El tipo debe estar en mayúsculas:

Correcto:

> [!NOTE]
> Esto es una nota.

También verifica que la etiqueta esté en su propia línea, sin nada más después en la misma línea.

4. La cita anidada se colapsa a un solo nivel

Causa: Caracteres > faltantes o inconsistentes en las líneas anidadas.

Incorrecto:

> Cita exterior.
>> Cita anidada.

Falta el espacio entre > y >:

Correcto:

> Cita exterior.
>
> > Cita anidada.

Siempre pon un espacio entre cada carácter > al anidar, e incluye una línea en blanco con > antes de anidar.

5. El bloque de código dentro de la cita se rompe

Causa: Falta el > en las líneas delimitadoras.

Incorrecto:

> Aquí hay algo de código:
```javascript
console.log("hola");
```
> De vuelta a la cita.

Correcto:

> Aquí hay algo de código:
>
> ```javascript
> console.log("hola");
> ```
>
> De vuelta a la cita.

Cada línea, incluyendo las líneas delimitadoras, necesita el prefijo >.

6. Las líneas de continuación perezosa se renderizan como párrafo normal

Causa: El parser no soporta la continuación perezosa.

Arriesgado:

> Primera línea de la cita.
Segunda línea sin >.

Siempre seguro:

> Primera línea de la cita.
> Segunda línea con >.

---

Buenas Prácticas para Citas en Markdown

Las citas son una de las funcionalidades más versátiles de markdown. Soportan todo, desde citas simples hasta callouts y alertas complejas.

Cuando algo no se renderiza como esperabas, revisa las reglas de formato comunes arriba. La mayoría de los problemas provienen de caracteres > faltantes o problemas de espaciado.

---

Preguntas Frecuentes

¿Qué es una cita (blockquote) en markdown?

Una cita es un bloque de texto que se separa visualmente del contenido circundante, normalmente con un borde izquierdo, relleno y a veces texto en cursiva o atenuado. En markdown, cualquier línea que comience con > se convierte en parte de una cita.

¿Se pueden anidar citas en markdown?

Sí. Añade otro > por cada nivel de anidamiento: > > para dos niveles, > > > para tres, y así sucesivamente. Siempre pon un espacio entre cada carácter >.

¿Cómo termino una cita?

Deja una línea en blanco (sin >) después de la última línea citada. La siguiente línea de texto será un párrafo normal.

¿Puedo poner bloques de código dentro de una cita?

Sí. Usa bloques de código delimitados (triple acento grave) y pon el prefijo > en cada línea, incluyendo las líneas delimitadoras.

¿Por qué mi alerta de GitHub no se muestra con colores?

Las alertas de GitHub solo se renderizan en GitHub mismo (incluyendo GitHub Issues, pull requests, wikis y READMEs). Fuera de GitHub, se muestran como citas normales con el texto [!NOTE] visible. También verifica que el tipo de alerta esté en mayúsculas y en su propia línea.

¿Cuál es la diferencia entre una cita y un callout?

Una cita (blockquote) es markdown estándar (>). Un callout es una variante con estilo: las alertas de GitHub y los callouts de Obsidian usan la sintaxis de citas con una etiqueta extra ([!NOTE], [!warning]) para activar un estilo especial. Los callouts son extensiones de plataforma, no markdown básico.

¿Cómo cito a alguien y añado atribución?

Añade una línea después de la cita con la fuente:

> La optimización prematura es la raíz de todo mal.
>
> Donald Knuth

¿Puedo estilizar las citas con colores personalizados?

No con markdown puro: las citas heredan el estilo que aplique la plataforma. En un sitio que controles, sobrescribe el CSS de <blockquote>. Dentro del contenido markdown, usa HTML sin procesar con estilos en línea si la plataforma lo permite.

¿Las citas funcionan en todos los sabores de markdown?

Sí. Las citas son parte de la especificación original de John Gruber y están soportadas por todos los parsers de markdown, incluyendo CommonMark, GFM, MultiMarkdown, Pandoc y variantes de plataformas como Discord, Slack y Reddit.

¿Por qué mi cita se rompe en Reddit?

Reddit requiere una línea en blanco antes de cualquier cita. Además, el markdown de Reddit es más estricto que GFM: si el > no está al principio de la línea (sin espacios delante), no se renderizará.

¿Puedo tener una cita vacía?

Técnicamente sí, > en una línea por sí solo produce un bloque de cita vacío, pero rara vez es útil. La mayoría de los parsers simplemente renderizan un borde fino sin contenido.

¿Qué longitud debería tener una cita?

No hay límite técnico. Estilísticamente, las citas cortas (una o dos frases) funcionan bien como citas destacadas. Las citas más largas (un párrafo o más) funcionan para citaciones extensas. Si una cita se extiende más allá de unos pocos párrafos, considera parafrasear o resumir en su lugar.