Cites en Markdown explicades: la guia completa de blockquotes

La guia completa de les cites en Markdown. Aprèn la sintaxi, l'anidament, les alertes de GitHub, els callouts d'Obsidian, l'estilització, la compatibilitat entre plataformes i tots els altres casos d'ús amb què et trobaràs.

Benjamin McBrayer // Publicat: 24 d’abril del 202612 min de lectura

També en

English Deutsch Español Français Italiano Português

Una cita en bloc (blockquote) és una manera de destacar text que prové d'una altra font o que necessita un èmfasi addicional, com ara una citació, una nota o un exemple. En Markdown, les cites en bloc són fàcils de crear amb un símbol senzill, cosa que les fa útils per a escriptors, blocaires, estudiants i qualsevol persona que publiqui contingut en línia. Aquesta guia t'ensenyarà què són les cites en bloc i com utilitzar-les correctament en Markdown.

Resposta ràpida: com es crea una cita en bloc en Markdown?

Per crear una cita en bloc en Markdown, afegeix un signe més gran que (>) seguit d'un espai a l'inici de qualsevol línia. Tota la línia es converteix en un bloc citat.

> Això és una cita en bloc.

Es renderitza com:

Això és una cita en bloc.

Aquesta és tota la sintaxi bàsica. La resta d'aquesta guia cobreix cites de diverses línies, anidament, alertes de GitHub, callouts d'Obsidian, estilització, compatibilitat entre plataformes i tots els altres casos d'ús amb què et trobaràs. Per a una referència més àmplia, consulta la nostra guia ràpida completa de Markdown.

Sintaxi bàsica de les cites en bloc en Markdown

Tota cita en bloc de Markdown comença amb > al principi d'una línia.

> Això és una cita en bloc d'una sola línia.

Es renderitza com:

Això és una cita en bloc d'una sola línia.

L'espai després de > és opcional però recomanable. Tots dos exemples funcionen de manera idèntica en la majoria de parsers:

> Amb un espai
>Sense espai

Per a la màxima compatibilitat, especialment amb parsers més estrictes de CommonMark, inclou sempre l'espai.

Per què el caràcter >? Markdown va manllevar la seva sintaxi de cites en bloc dels convenis del correu electrònic. Quan respons un correu, el text citat sovint apareix prefixat amb >. Gruber va mantenir aquesta convenció perquè ja resultava familiar a qualsevol persona que hagués utilitzat el correu electrònic des dels anys vuitanta.

Cites de diverses línies en Markdown

Diverses línies en el mateix paràgraf

Afegeix > a l'inici de cada línia:

> Aquesta és la línia u de la cita en bloc.
> Aquesta és la línia dos.
> Aquesta és la línia tres.

Es renderitza com un sol paràgraf:

Aquesta és la línia u de la cita en bloc. Aquesta és la línia dos. Aquesta és la línia tres.

Continuació mandrosa (no recomanada)

Alguns parsers permeten ometre el > a les línies de continuació:

> Aquesta és la línia u.
Aquesta és la línia dos (estil mandrós).

Això funciona en CommonMark i GitHub Flavored Markdown, però alguns parsers ho trenquen. Prefixa sempre cada línia amb > per garantir la compatibilitat.

Cites en bloc amb diversos paràgrafs

Per incloure diversos paràgrafs dins d'una mateixa cita en bloc, separa'ls amb una línia que només contingui >:

> Aquest és el primer paràgraf de la cita en bloc.
>
> Aquest és el segon paràgraf. Fixa't en la línia `>` buida de sobre.
>
> I aquest és un tercer paràgraf.

Es renderitza com:

Aquest és el primer paràgraf de la cita en bloc.

Aquest és el segon paràgraf. Fixa't en la línia > buida de sobre.

I aquest és un tercer paràgraf.

Regla crítica: la línia en blanc entre paràgrafs ha de contenir igualment un caràcter >. Sense aquest, la cita en bloc acaba i en comença una de nova, que normalment no és el que vols.

Cites en bloc anidades en Markdown

Apila caràcters > per anidar cites en bloc l'una dins l'altra:

> Aquesta és la cita de primer nivell.
>
> > Aquesta és una cita anidada dins de la primera.
> >
> > > I aquesta està anidada tres nivells.
>
> Tornem al primer nivell.

Es renderitza com:

Aquesta és la cita de primer nivell.

Aquesta és una cita anidada dins de la primera.

I aquesta està anidada tres nivells.

Tornem al primer nivell.

L'anidament és habitual a les cadenes de resposta per correu electrònic, on cada nivell de > representa una nova ronda de citacions. A la pràctica, baixar més enllà de dos o tres nivells es fa difícil de llegir, així que val la pena reestructurar el contingut abans d'arribar a quatre nivells de profunditat.

Format dins de les cites en bloc de Markdown

Les cites en bloc poden contenir gairebé qualsevol altre element de Markdown. Posa cada element a la seva pròpia línia, sempre prefixada amb >.

Format de text

> Pots utilitzar **negreta**, *cursiva*, ***negreta cursiva***,
> ~~ratllat~~ i `codi en línia` dins de cites en bloc.

Es renderitza com:

Pots utilitzar negreta, cursiva, negreta cursiva, ~~ratllat~~ i codi en línia dins de cites en bloc.

Encapçalaments

> ### Això és un encapçalament dins d'una cita en bloc
>
> I això és text normal a sota.

Es renderitza com:

### Això és un encapçalament dins d'una cita en bloc

I això és text normal a sota.

Llistes

Funcionen tant les llistes ordenades com les no ordenades:

> **Revisió trimestral:**
>
> - Els ingressos van créixer un 23%
> - La plantilla va augmentar en 12 persones
> - L'abandonament de clients va baixar al 3%
>
> *Totes les mètriques van en la direcció correcta.*

Es renderitza com:

Revisió trimestral:

Els ingressos van créixer un 23%

La plantilla va augmentar en 12 persones

L'abandonament de clients va baixar al 3%

Totes les mètriques van en la direcció correcta.

Blocs de codi

Els blocs de codi delimitats per fences funcionen dins de cites en bloc, però cada línia continua necessitant el prefix >:

> Executa la següent ordre per instal·lar:
>
> ```bash
> npm install markdown-it
> ```
>
> Després, reinicia la teva aplicació.

Enllaços i imatges

> Per a més informació, visita la [nostra documentació](https://example.com).
>
> ![Logotip](https://example.com/logo.png)

El que no funciona de manera fiable

Les taules dins de cites en bloc funcionen en GitHub Flavored Markdown, però fallen en parsers més estrictes. Prova-ho abans de confiar-hi.
Les línies horitzontals dins de cites en bloc (---) són ambigües i es renderitzen de manera inconsistent.
Els elements de bloc HTML dins de cites en bloc es comporten de manera impredictible segons el parser.

Alertes de GitHub (notes, advertències, consells)

GitHub Flavored Markdown (GFM) amplia la sintaxi de cites en bloc amb cinc tipus d'alertes especials que es renderitzen amb colors i icones distintius a GitHub, GitHub Issues, READMEs i pull requests.

Sintaxi

> [!NOTE]
> Informació útil que els usuaris haurien de saber, fins i tot quan llegeixen per sobre.

> [!TIP]
> Consells útils per fer les coses millor o més fàcilment.

> [!IMPORTANT]
> Informació clau que els usuaris necessiten saber per assolir el seu objectiu.

> [!WARNING]
> Informació urgent que requereix atenció immediata de l'usuari per evitar problemes.

> [!CAUTION]
> Adverteix sobre riscos o conseqüències negatives de determinades accions.

Regles per a les alertes de GitHub

El tipus d'alerta ([!NOTE], [!TIP], etc.) ha d'estar en la seva pròpia línia a l'inici de la cita en bloc.
Els tipus d'alerta distingeixen entre majúscules i minúscules: [!note] no funcionarà.
L'alerta s'aplica a tota la cita en bloc que la segueix.
Només un tipus d'alerta per cita en bloc. No es permet barrejar tipus.

Quan utilitzar cada tipus

Alerta	Útil per a
`[!NOTE]`	Context útil que no és crític però ajuda el lector
`[!TIP]`	Consell opcional que fa que alguna cosa sigui més fàcil o millor
`[!IMPORTANT]`	Informació que el lector ha de conèixer per tenir èxit
`[!WARNING]`	Alguna cosa que podria sortir malament si s'ignora
`[!CAUTION]`	Riscos seriosos, pèrdua de dades, problemes de seguretat, accions irreversibles

Les alertes de GitHub funcionen en READMEs de repositoris, pàgines de wiki, issues, pull requests i discussions. No es renderitzen com a alertes fora de GitHub; en altres llocs, es mostren com a cites en bloc normals amb el text [!NOTE] visible com a text pla.

Callouts d'Obsidian

Obsidian utilitza una sintaxi semblant a la de les alertes de GitHub, però amb moltes més opcions. La sintaxi és > [!tipus] seguit del contingut:

> [!note] Títol personalitzat aquí
> Aquest és un callout de tipus nota amb un títol personalitzat.

> [!warning]
> Aquest és un callout d'advertència.

> [!tip] Consell pro
> Els callouts poden tenir títols personalitzats per a un context addicional.

Tipus de callouts d'Obsidian

Obsidian admet més d'una dotzena de tipus de callouts, cadascun amb colors i icones diferents:

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

Afegeix un + o un - després del tipus per fer-los plegables:

> [!note]+ Clica per desplegar (comença obert)
> Contingut amagat darrere d'un toggle.

> [!warning]- Clica per desplegar (comença tancat)
> Plegat per defecte.

Callouts anidats

Els callouts es poden anidar igual que les cites en bloc normals:

> [!note] Callout exterior
> Aquest és el contingut exterior.
>
> > [!tip] Callout interior
> > Aquest està anidat a dins.

Els callouts d'Obsidian són el motiu pel qual molts usuaris de Markdown prefereixen Obsidian per prendre notes: converteixen les cites en bloc normals en quadres d'informació rics i amb estil.

Quan utilitzar cites en bloc

Les cites en bloc són versàtils. Aquí tens les cinc situacions més habituals en què les utilitzaràs, amb exemples que t'ajudaran a entendre-ho.

1. Citar algú

El propòsit original. Atribueix les cites a la seva font amb una línia per a l'atribució:

> La millor manera de predir el futur és inventar-lo.
>
> Alan Kay

Es renderitza com:

La millor manera de predir el futur és inventar-lo.

Alan Kay

Estil acadèmic amb citació adequada:

> Markdown és una eina de conversió de text a HTML per a escriptors web. Markdown
> et permet escriure utilitzant un format de text pla fàcil de llegir i fàcil
> d'escriure, per després convertir-lo en XHTML (o HTML) estructuralment vàlid.
>
> John Gruber, [Daring Fireball](https://daringfireball.net/projects/markdown/)

2. Pull quotes en contingut de llarga durada

Extreu una frase memorable del cos del text per cridar l'atenció visual:

L'equip va llançar la funcionalitat en un temps rècord. La moral es va disparar. Els ingressos també.

> En tres mesos, vam passar de zero usuaris a quaranta mil.

El que va marcar la diferència no va ser el codi, sinó el moment.

3. Callouts i notes

Abans que existissin les alertes de GitHub, la gent feia servir cites en bloc amb etiquetes en negreta per crear callouts:

> **Nota:** Aquesta funcionalitat requereix Node.js 18 o superior.

> **Advertència:** Executar aquesta ordre eliminarà totes les dades de la base de dades.

> **Consell:** Pots saltar-te el pas de configuració utilitzant el flag `--auto`.

Encara s'utilitzen molt en plataformes que no admeten alertes de GitHub.

4. Respostes i citacions d'estil correu electrònic

En discussions, issues i pull requests:

> Hauríem d'utilitzar PostgreSQL o MySQL per a això?

PostgreSQL: millor suport per a JSON i un sistema de tipus més robust.

5. Citacions amb fonts

Per a escriptura acadèmica, periodística o tècnica:

> El 78% dels desenvolupadors afirmen utilitzar Markdown diàriament.
>
> Un article interessant sobre Markdown, 2025

Estilitzar cites en bloc amb CSS

El Markdown pur no té opcions d'estil. Les cites en bloc es renderitzen tal com decideix la plataforma. La majoria de renderitzadors utilitzen, per defecte, una vora esquerra, text gris i una mica de farciment (padding).

Estil personalitzat al teu propi lloc

Si publiques Markdown en un lloc que controles (Jekyll, Hugo, Ghost, Next.js i similars), sobreescriu 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;
}

Alternativa amb HTML en línia

Quan necessites un estil concret per a una cita en bloc dins de Markdown i la plataforma permet HTML cru:

<blockquote style="border-left: 4px solid #e74c3c; padding-left: 1em; color: #666;">
  Aquesta és una cita amb estil personalitzat.
</blockquote>

Això funciona a GitHub, a la majoria de generadors de llocs estàtics i a Ghost. No funciona a Reddit, Discord ni Slack (que descarten l'HTML en línia).

Compatibilitat entre plataformes

Les cites en bloc són una de les funcionalitats de Markdown amb més suport universal. Funcionen pràcticament a tot arreu, però amb variacions específiques de cada plataforma que val la pena conèixer.

| Plataforma     | Cites en bloc | Anidades | Alertes 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í       | Com a callout  | Sí          |
| Stack Overflow | Sí            | Sí       | No             | No          |
| Jekyll / Hugo  | Sí            | Sí       | Via plugin     | No          |

Notes específiques de cada plataforma

Discord admet cites d'una línia i de diverses línies, però no admet l'anidament. Utilitza > per a una sola línia o >>> a l'inici per a una cita de diverses línies que continua fins al final del missatge.

Slack renderitza > com una cita, però no admet l'anidament. Les cites de diverses línies requereixen > a cada línia.

Reddit requereix una línia en blanc abans de qualsevol cita en bloc perquè es renderitzi. Aquesta és la causa més habitual que les cites en bloc fallin a Reddit.

Notion converteix automàticament l'entrada > en el seu propi bloc de cita. Les cites anidades requereixen arrossegar blocs els uns dins dels altres.

Per a més peculiaritats de cada plataforma, consulta la nostra guia completa de compatibilitat a la guia ràpida principal.

Errors habituals i com solucionar-los

1. La cita en bloc no es renderitza

Causa: falta una línia en blanc abans o després de la cita en bloc.

Incorrecte:

Aquí hi ha text normal.
> Això hauria de ser una cita en bloc.
Més text.

Correcte:

Aquí hi ha text normal.

> Això hauria de ser una cita en bloc.

Més text.

La majoria de parsers són tolerants amb això, però els més estrictes (incloent-hi Reddit) requereixen línies en blanc a banda i banda.

2. La cita en bloc de diversos paràgrafs es divideix en dues

Causa: la línia en blanc entre paràgrafs no té >.

Incorrecte:

> Primer paràgraf.

> Segon paràgraf (això es converteix en una cita en bloc separada).

Correcte:

> Primer paràgraf.
>
> Segon paràgraf (ara forma part de la mateixa cita en bloc).

La línia separadora en blanc ha de contenir igualment >.

3. L'alerta de GitHub es renderitza com una cita en bloc normal

Causa: l'etiqueta d'alerta està a la línia equivocada, té majúscules incorrectes o conté espais addicionals.

Incorrecte:

> [!note]
> Això és una nota.

El tipus ha d'estar en majúscules:

Correcte:

> [!NOTE]
> Això és una nota.

Comprova també que l'etiqueta estigui en la seva pròpia línia, sense res més a la mateixa línia.

4. La cita en bloc anidada es redueix a un sol nivell

Causa: falten o són inconsistents els caràcters > a les línies anidades.

Incorrecte:

> Cita exterior.
>> Cita anidada.

Falta l'espai entre > i >:

Correcte:

> Cita exterior.
>
> > Cita anidada.

Posa sempre un espai entre cada caràcter > quan anides, i inclou una línia > en blanc abans d'anidar.

5. Un bloc de codi dins d'una cita en bloc es trenca

Causa: falten els > a les línies de la fence.

Incorrecte:

> Aquí hi ha codi:
```javascript
console.log("hello");
```
> Tornem a la cita.

Correcte:

> Aquí hi ha codi:
>
> ```javascript
> console.log("hello");
> ```
>
> Tornem a la cita.

Cada línia, incloent-hi les línies de la fence, necessita el prefix >.

6. Les línies amb continuació mandrosa es renderitzen com a paràgraf normal

Causa: el parser no admet la continuació mandrosa.

Arriscat:

> Primera línia de la cita.
Segona línia sense >.

Sempre segur:

> Primera línia de la cita.
> Segona línia amb >.

Bones pràctiques per a les cites en bloc de Markdown

Les cites en bloc són una de les funcionalitats més versàtils de Markdown. Suporten des de cites simples fins a callouts i alertes complexos.

Quan alguna cosa no es renderitza com s'esperava, comprova les regles de format habituals que hi ha més amunt. La majoria de problemes provenen de caràcters > que falten o de problemes d'espaiat.

Preguntes freqüents

Què és una cita en bloc en Markdown?

Una cita en bloc és un bloc de text que es presenta visualment separat del contingut que l'envolta, normalment amb una vora esquerra, farciment i, de vegades, text en cursiva o més apagat. En Markdown, qualsevol línia que comenci amb > passa a formar part d'una cita en bloc.

Puc anidar cites en bloc en Markdown?

Sí. Afegeix un altre > per cada nivell d'anidament: > > per a dos nivells, > > > per a tres, i així successivament. Posa sempre un espai entre cada caràcter >.

Com s'acaba una cita en bloc?

Deixa una línia en blanc (sense >) després de l'última línia citada. La següent línia de text serà un paràgraf normal.

Puc posar blocs de codi dins d'una cita en bloc?

Sí. Utilitza blocs de codi amb fences (triple backtick) i prefixa cada línia, incloses les línies de la fence, amb >.

Per què la meva alerta de GitHub no es mostra amb color?

Les alertes de GitHub només es renderitzen al mateix GitHub (incloses GitHub Issues, pull requests, wikis i READMEs). Fora de GitHub, es mostren com a cites en bloc normals amb el text [!NOTE] visible. Comprova també que el tipus d'alerta estigui en majúscules i en la seva pròpia línia.

Quina diferència hi ha entre una cita en bloc i un callout?

Una cita en bloc és Markdown estàndard (>). Un callout és una variant amb estil: les alertes de GitHub i els callouts d'Obsidian utilitzen la sintaxi de cita en bloc amb una etiqueta addicional ([!NOTE], [!warning]) per activar un estil especial. Els callouts són extensions de plataforma, no Markdown bàsic.

Com cito algú i hi afegeixo una atribució?

Afegeix una línia després de la cita amb la font:

> L'optimització prematura és l'arrel de tots els mals.
>
> Donald Knuth

Puc estilitzar les cites en bloc amb colors personalitzats?

No amb Markdown pur: les cites en bloc hereten l'estil que aplica la plataforma. En un lloc que controles, sobreescriu el CSS de <blockquote>. Dins del contingut Markdown, utilitza HTML cru amb estils en línia si la plataforma ho permet.

Les cites en bloc funcionen en totes les variants de Markdown?

Sí. Les cites en bloc formen part de l'especificació original de John Gruber i les admet tots els parsers de Markdown, incloent-hi CommonMark, GFM, MultiMarkdown, Pandoc i variants de plataforma com Discord, Slack i Reddit.

Per què la meva cita en bloc es trenca a Reddit?

Reddit requereix una línia en blanc abans de qualsevol cita en bloc. A més, el Markdown de Reddit és més estricte que GFM: si el > no comença al principi de la línia (sense espais inicials), no es renderitzarà.

Puc tenir una cita en bloc buida?

Tècnicament sí: un > tot sol en una línia produeix un bloc citat buit, però poques vegades és útil. La majoria de parsers només renderitzen una vora prima sense contingut.

Quina longitud ha de tenir una cita en bloc?

No hi ha cap límit tècnic. Estilísticament, les cites curtes (una o dues frases) funcionen bé com a pull quotes. Les cites més llargues (un paràgraf o més) funcionen per a citacions extenses. Si una cita s'allarga més d'uns quants paràgrafs, considera parafrasejar-la o resumir-la.