Explicación de Markdown Blockquotes: la guía completa de cotizaciones
La guía completa para las citas en bloque de rebajas. Aprenda la sintaxis, el anidamiento, las alertas de GitHub, las leyendas de Obsidian, el estilo, la compatibilidad de la plataforma y todos los demás casos de uso que encontrará.
Una cita en bloque es una forma de resaltar texto que proviene de otra fuente o que necesita énfasis adicional, como una cita, una nota o un ejemplo. En Markdown, las citas en bloque son fáciles de crear con un símbolo simple, lo que las hace útiles para escritores, blogueros, estudiantes y cualquiera que publique contenido en línea. Esta guía le mostrará qué son las citas en bloque y cómo usarlas correctamente en Markdown.
Respuesta rápida: ¿Cómo se crea una cita en bloque en Markdown?
Para crear una cita en bloque en Markdown, agregue un signo mayor que (>) seguido de un espacio al comienzo de cualquier línea. Toda la línea se convierte en un bloque entre comillas.
> This is a blockquote.
Se representa como:
Esta es una cita en bloque.
Esa es toda la sintaxis básica. El resto de esta guía cubre citas de varias líneas, anidamiento, alertas de GitHub, llamadas de Obsidian, estilo, compatibilidad de plataforma y todos los demás casos de uso que encontrará. Para obtener una referencia más amplia, consulte nuestra hoja de trucos de rebajas completa.
Sintaxis básica de citas en bloque en Markdown
Cada cita en bloque de rebajas comienza con > al principio de una línea.
> This is a single-line blockquote.
Se representa como:
Esta es una cita en bloque de una sola línea.
El espacio después de > es opcional pero recomendado. Ambos funcionan de manera idéntica en la mayoría de los analizadores:
> With a space
>Without a space
Para obtener la máxima compatibilidad, especialmente en analizadores CommonMark más estrictos, incluya siempre el espacio.
¿Por qué el carácter >? Markdown tomó prestada su sintaxis de citas en bloque de las convenciones de correo electrónico. Cuando responde a un correo electrónico, el texto entre comillas suele tener el prefijo >. Gruber mantuvo la convención porque ya era familiar para cualquiera que hubiera usado el correo electrónico desde la década de 1980.
Cotizaciones de varias líneas en Markdown
Varias líneas en el mismo párrafo
Agregue > al inicio de cada línea:
> This is line one of the blockquote.
> This is line two.
> This is line three.
Se representa como un solo párrafo:
Esta es la línea uno de la cita en bloque. Esta es la línea dos. Esta es la línea tres.
Continuación perezosa (no recomendada)
Algunos analizadores le permiten colocar > en las líneas de continuación:
> This is line one.
This is line two (lazy style).
Esto funciona en CommonMark y GitHub Flavored Markdown, pero algunos analizadores no funcionan. Siempre preceda cada línea con > para mayor compatibilidad.
Citas en bloque de varios párrafos
Para varios párrafos dentro de una sola cita en bloque, sepárelos con una línea que contenga solo >:
> This is the first paragraph of the blockquote.
>
> This is the second paragraph. Notice the blank `>` line above.
>
> And this is a third paragraph.
Se representa como:
Este es el primer párrafo de la cita en bloque.
Este es el segundo párrafo. Observe la línea
>en blanco arriba.Y este es un tercer párrafo.
Regla crítica: La línea en blanco entre párrafos aún debe tener un carácter >. Sin él, la cita en bloque termina y comienza una nueva, que normalmente no es lo que desea.
Cotizaciones en bloque de rebajas anidadas
Apile caracteres > para anidar comillas en bloque una dentro de otra:
> This is the first-level quote.
>
> > This is a nested quote inside the first one.
> >
> > > And this is nested three levels deep.
>
> Back to the first level.
Se representa como:
Esta es la cita de primer nivel.
Esta es una cita anidada dentro de la primera.
Y esto está anidado en tres niveles de profundidad.
Regresar al primer nivel.
El anidamiento es común en cadenas de respuesta de estilo correo electrónico, donde cada nivel de > representa otra ronda de citas. En la práctica, profundizar más de dos o tres niveles se vuelve difícil de leer, así que considere reestructurar el contenido antes de anidar cuatro niveles de profundidad.
Formato dentro de las citas en bloque de Markdown
Las citas en bloque pueden contener la mayoría de los demás elementos de rebajas. Coloque cada elemento en su propia línea, todavía con el prefijo >.
Formato de texto
> You can use **bold**, *italic*, ***bold italic***,
> ~~strikethrough~~, and `inline code` inside blockquotes.
Se representa como:
Puedes usar negrita, cursiva, negrita cursiva,
tachadoycódigo en líneadentro de comillas.
Encabezados
> ### This is a heading inside a blockquote
>
> And this is regular text below it.
Se representa como:
### Este es un encabezado dentro de una cita en bloque
Y este es el texto normal debajo de él.
Listas
Tanto las listas ordenadas como las desordenadas funcionan:
> **Quarterly Review:**
>
> - Revenue grew 23%
> - Headcount increased by 12
> - Customer churn dropped to 3%
>
> *All metrics are trending in the right direction.*
Se representa como:
Revisión trimestral:
- Los ingresos crecieron un 23%
- La plantilla aumentó en 12
- La rotación de clientes cayó al 3%
Todas las métricas van en la dirección correcta.
Bloques de código
Los bloques de código protegido funcionan dentro de comillas, pero cada línea aún necesita el prefijo >:
> Run the following command to install:
>
> ```fiesta
> npm instala markdown-it
>```
>
> Then restart your application.
Enlaces e imágenes
> For more info, visit [our documentation](https://example.com).
>
> 
Lo que no funciona de forma fiable
- Las tablas dentro de comillas en bloque funcionan en GitHub Flavored Markdown pero fallan en analizadores más estrictos. Pruebe antes de confiar en ellos.
- Las reglas horizontales dentro de comillas (
---) son ambiguas y se muestran de manera inconsistente. - Los elementos de bloque HTML dentro de comillas en bloque se comportan de manera impredecible entre los analizadores.
Alertas de GitHub (notas, advertencias, sugerencias)
GitHub Flavored Markdown (GFM) amplía la sintaxis de citas en bloque con cinco tipos de alertas especiales que se representan con distintos colores e íconos en GitHub, GitHub Issues, README y pull request.
Sintaxis
> [!NOTE]
> Useful information that users should know, even when skimming.
> [!TIP]
> Helpful advice for doing things better or more easily.
> [!IMPORTANT]
> Key information users need to know to achieve their goal.
> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.
> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.
Reglas para alertas de GitHub
- El tipo de alerta (
[!NOTE],[!TIP], etc.) debe estar en su propia línea al inicio de la cita en bloque. - Los tipos de alerta distinguen entre mayúsculas y minúsculas,
[!note]no funcionará. - La alerta se aplica a toda la cita en bloque que sigue.
- Sólo un tipo de alerta por cita en bloque. No se admiten tipos de mezcla.
Cuándo utilizar cada tipo
| Alerta | Usar para |
|---|---|
[!NOTA] |
Contexto útil que no es crítico pero ayuda al lector |
[!CONSEJO] |
Consejos opcionales que hacen algo más fácil o mejor |
[!IMPORTANTE] |
Información que el lector debe saber para tener éxito |
[!ADVERTENCIA] |
Algo que podría salir mal si se ignora |
[!PRECAUCIÓN] |
Riesgos graves, pérdida de datos, problemas de seguridad, acciones irreversibles |
Las alertas de GitHub funcionan en archivos README del repositorio, páginas wiki, incidencias, solicitudes de extracción y debates. No se muestran como alertas fuera de GitHub; en otros lugares recurren a citas en bloque normales con el texto [!NOTE] visible como texto sin formato.
Llamadas de obsidiana
Obsidian usa una sintaxis similar a las alertas de GitHub pero con muchas más opciones. La sintaxis es > [!type] seguida del contenido:
> [!note] Custom title here
> This is a note callout with a custom title.
> [!warning]
> This is a warning callout.
> [!tip] Pro tip
> Callouts can have custom titles for extra context.
Tipos de rótulos de obsidiana
Obsidian admite más de una docena de tipos de llamadas, cada una con distintos colores e íconos:
nota,información,abstracto,resumen,tldrconsejo,pista,importanteéxito,verificar,hechopregunta,ayuda,preguntas frecuentesadvertencia,precaución,atenciónfallo,fallo,faltantepeligro,errorerrorejemplocita,cita
Avisos plegables
Agregue un + o - después del tipo para que las leyendas sean plegables:
> [!note]+ Click to expand (starts open)
> Content hidden behind a toggle.
> [!warning]- Click to expand (starts closed)
> Collapsed by default.
Llamadas anidadas
Las leyendas se pueden anidar como las citas en bloque normales:
> [!note] Outer callout
> This is the outer content.
>
> > [!tip] Inner callout
> > This is nested inside.
Las leyendas de Obsidian son la razón por la que muchos usuarios de Markdown prefieren Obsidian para tomar notas: convierten las citas simples en cuadros de información ricos y con estilo.
Cuándo utilizar citas en bloque
Las citas en bloque son versátiles. A continuación se detallan las cinco situaciones más comunes en las que los utilizará, con ejemplos que le ayudarán a comprenderlas.
1. Citando a otra persona
El propósito original. Atribuya las citas a su fuente con una línea de atribución:
> The best way to predict the future is to invent it.
>
> Alan Kay
Se representa como:
La mejor manera de predecir el futuro es inventarlo.
Alan Kay
Estilo académico con citación adecuada:
> Markdown is a text-to-HTML conversion tool for web writers. Markdown
> allows you to write using an easy-to-read, easy-to-write plain text
> format, then convert it to structurally valid XHTML (or HTML).
>
> John Gruber, [Daring Fireball](https://daringfireball.net/projects/markdown/)
2. Extraer comillas en contenido de formato largo
Saque una frase memorable del cuerpo del texto para llamar la atención visual:
The team shipped the feature in record time. Morale soared. Revenue followed.
> In three months, we went from zero users to forty thousand.
What made the difference wasn't the code, it was the timing.
3. Rótulos y notas
Antes de que existieran las alertas de GitHub, la gente usaba citas en bloque con etiquetas en negrita para crear llamadas:
> **Note:** This feature requires Node.js 18 or higher.
> **Warning:** Running this command will delete all data in the database.
> **Tip:** You can skip the setup step by using the `--auto` flag.
Todavía se usa ampliamente en plataformas que no admiten alertas de GitHub.
4. Respuestas y citas al estilo de correo electrónico
En discusiones, problemas y solicitudes de extracción:
> Should we use PostgreSQL or MySQL for this?
PostgreSQL, better JSON support and stronger type system.
5. Citas con fuentes
Para redacción académica, periodística o técnica:
> 78% of developers report using markdown daily.
>
> An interesting article on markdown, 2025
Diseñar citas en bloque con CSS
La reducción pura no tiene opciones de estilo. Blockquotes se renderiza como decida la plataforma. La mayoría de los renderizadores utilizan un borde izquierdo, texto gris y algo de relleno de forma predeterminada.
Estilo personalizado en su propio sitio
Si publica rebajas en un sitio que controla (Jekyll, Hugo, Ghost, Next.js y similares), anule el CSS <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;
}
Reserva HTML en línea
Cuando necesita un estilo de cita en bloque específico dentro de Markdown y la plataforma permite HTML sin formato:
<blockquote style="border-left: 4px solid #e74c3c; padding-left: 1em; color: #666;">
This is a custom-styled quote.
</blockquote>
Esto funciona en GitHub, la mayoría de los generadores de sitios estáticos y Ghost. No funciona en Reddit, Discord o Slack (que eliminan el HTML en línea).
Compatibilidad de plataforma
Las citas en bloque son una de las funciones de rebajas más universalmente admitidas. Funcionan en casi todas partes, pero con variaciones específicas de cada plataforma que vale la pena conocer.
| Platform | Blockquotes | Nested | GitHub Alerts | Callouts |
| -------------- | :---------: | :----: | :-----------: | :---------- |
| GitHub (GFM) | Yes | Yes | Yes | No |
| GitLab | Yes | Yes | Partial | No |
| Bitbucket | Yes | Yes | No | No |
| Reddit | Yes | Yes | No | No |
| Discord | Yes | No | No | No |
| Slack | Yes | No | No | No |
| Notion | Yes | Yes | No | No |
| Obsidian | Yes | Yes | As callout | Yes |
| Stack Overflow | Yes | Yes | No | No |
| Jekyll / Hugo | Yes | Yes | Via plugin | No |
Notas específicas de la plataforma
Discord admite comillas de una o varias líneas, pero no admite el anidamiento. Utilice > para una sola línea o >>> al principio para una cita de varias líneas que continúa hasta el final del mensaje.
Slack representa > como una cita pero no admite el anidamiento. Las comillas de varias líneas requieren > en cada línea.
Reddit requiere una línea en blanco antes de cualquier cita en bloque para que se procese. Esta es la razón más común por la que las citas en bloque fallan en Reddit.
Notion convierte automáticamente la entrada > en su propio bloque de cotización. Las comillas anidadas requieren arrastrar bloques entre sí.
Para conocer más peculiaridades de la plataforma, consulte nuestra guía de compatibilidad completa en la hoja de referencia del pilar.
Errores y soluciones comunes
1. Blockquote no se procesa
Causa: Falta una línea en blanco antes o después de la cita en bloque.
Roto:
Here is regular text.
> This should be a blockquote.
More text.
Fijado:
Here is regular text.
> This should be a blockquote.
More text.
La mayoría de los analizadores son indulgentes con esto, pero los más estrictos (incluido Reddit) requieren líneas en blanco a ambos lados.
2. La cita en bloque de varios párrafos se divide en dos
Causa: La línea en blanco entre párrafos no tiene un >.
Roto:
> First paragraph.
> Second paragraph (this becomes a separate blockquote).
Fijado:
> First paragraph.
>
> Second paragraph (now part of the same blockquote).
La línea separadora en blanco aún debe contener >.
3. La alerta de GitHub se representa como una cita en bloque simple
Causa: La etiqueta de alerta está en la línea incorrecta, está mal escrita o tiene espacios adicionales.
Roto:
> [!note]
> This is a note.
El tipo debe ser mayúscula:
Fijado:
> [!NOTE]
> This is a note.
También verifique que la etiqueta esté en su propia línea, sin nada después en la misma línea.
4. La cita en bloque anidada se colapsa en un solo nivel
Causa: Caracteres > faltantes o inconsistentes en líneas anidadas.
Roto:
> Outer quote.
>> Nested quote.
Falta espacio entre > y >:
Fijado:
> Outer quote.
>
> > Nested quote.
Siempre coloque un espacio entre cada carácter > al anidar e incluya una línea > en blanco antes de anidar.
5. Bloque de código dentro de saltos de citas en bloque
Causa: Falta > en las líneas de la cerca.
Roto:
> Here's some code:
```javascript
console.log("hola");```
> Back to the quote.
Fijado:
> Here's some code:
>
> ```javascript
> console.log("hola");
>```
>
> Back to the quote.
Cada línea, incluidas las líneas de la cerca, necesita el prefijo >.
6. Las líneas de continuación diferidas se representan como un párrafo normal
Causa: El analizador no admite la continuación diferida.
Arriesgado:
> First line of the quote.
Second line without >.
Siempre seguro:
> First line of the quote.
> Second line with >.
Mejores prácticas de Markdown Blockquote
Las citas en bloque son una de las funciones de rebajas más versátiles. Admiten todo, desde citas simples hasta llamadas y alertas complejas.
Cuando algo no se procesa como se esperaba, consulte las reglas de formato comunes anteriores. La mayoría de los problemas provienen de caracteres > faltantes o problemas de espaciado.
Preguntas frecuentes
¿Qué es una cita en bloque en Markdown?
Una cita en bloque es un bloque de texto que se distingue visualmente del contenido circundante, generalmente con un borde izquierdo, relleno y, a veces, texto en cursiva o silenciado. En Markdown, cualquier línea que comience con > se convierte en parte de una cita en bloque.
¿Puedo anidar citas en bloque en rebajas?
Sí. Agregue otro > para cada nivel de anidamiento, > > para dos niveles, > > > para tres, y así sucesivamente. Siempre coloque un espacio entre cada carácter >.
¿Cómo finalizo una cita en bloque?
Deje 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 en bloque?
Sí. Utilice bloques de código cercados (comillas invertidas triples) y anteponga cada línea, incluidas las líneas de la cerca, con >.
¿Por qué mi alerta de GitHub no aparece en color?
Las alertas de GitHub solo se muestran en el propio GitHub (incluidos los problemas de GitHub, las solicitudes de extracción, los wikis y los archivos README). Fuera de GitHub, recurren a citas en bloque normales con el texto [!NOTE] visible. También verifique que el tipo de alerta esté en mayúsculas y en su propia línea.
¿Cuál es la diferencia entre una cita en bloque y una leyenda?
Una cita en bloque es una rebaja estándar (>). Una llamada es una variante con estilo, las alertas de GitHub y las llamadas de Obsidian usan la sintaxis de comillas en bloque con una etiqueta adicional ([!NOTE], [!warning]) para activar un estilo especial. Los textos destacados son extensiones de la plataforma, no rebajas principales.
¿Cómo cito a alguien y agrego atribución?
Agregue una línea después de la cita con la fuente:
> Premature optimization is the root of all evil.
>
> Donald Knuth
¿Puedo diseñar citas en bloque con colores personalizados?
No con rebajas puras, las citas en bloque heredan cualquier estilo que aplique la plataforma. En un sitio que usted controle, anule el CSS <blockquote>. Dentro del contenido de rebajas, utilice HTML sin formato con estilos en línea si la plataforma lo permite.
¿Las citas en bloque funcionan en todos los tipos de rebajas?
Sí. Blockquotes son parte de la especificación original de John Gruber y son compatibles con todos los analizadores de rebajas, incluidos CommonMark, GFM, MultiMarkdown, Pandoc y variantes de plataformas como Discord, Slack y Reddit.
¿Por qué mi cita en bloque se rompe en Reddit?
Reddit requiere una línea en blanco antes de cualquier cita en bloque. Además, la reducción de Reddit es más estricta que GFM, si > no comienza al principio de una línea (sin espacios iniciales), no se procesará.
¿Puedo tener una cita en bloque vacía?
Técnicamente sí, > en su propia línea produce un bloque entre comillas vacío, pero rara vez es útil. La mayoría de los analizadores simplemente muestran un borde delgado sin contenido.
¿Cuánto tiempo debe tener una cita en bloque?
No hay límite técnico. Estilísticamente, las citas breves (una o dos oraciones) funcionan bien como citas extraídas. Las citas más largas (un párrafo o más) funcionan para citas extendidas. Si una cita tiene más de unos pocos párrafos, considere parafrasear o resumir.