Torna al blog

Spiegazione di Markdown Blockquotes: la guida completa alle citazioni

La guida completa alle quote di ribasso. Impara la sintassi, la nidificazione, gli avvisi GitHub, i callout Obsidian, lo stile, la compatibilità della piattaforma e ogni altro caso d'uso che incontrerai.

Benjamin McBrayer // Pubblicato: 24 aprile 202611 min di lettura

Una citazione in blocco è un modo per evidenziare un testo che proviene da un'altra fonte o che necessita di ulteriore enfasi, come una citazione, una nota o un esempio. In Markdown, le virgolette sono facili da creare con un semplice simbolo, rendendole utili per scrittori, blogger, studenti e chiunque pubblichi contenuti online. Questa guida ti mostrerà cosa sono i blockquote e come usarli correttamente in Markdown.

Risposta rapida: come si crea un Blockquote in Markdown?

Per creare una virgoletta in blocco in markdown, aggiungi un segno maggiore di (>) seguito da uno spazio all'inizio di qualsiasi riga. L'intera riga diventa un blocco tra virgolette.

> This is a blockquote.

Visualizza come:

Questa è una citazione in blocco.

Questa è l'intera sintassi di base. Il resto di questa guida tratta virgolette su più righe, nidificazione, avvisi GitHub, callout Obsidian, stili, compatibilità della piattaforma e ogni altro caso d'uso che incontrerai. Per un riferimento più ampio, consulta il nostro cheatsheet completo sul markdown.


Sintassi di base delle virgolette in Markdown

Ogni virgoletta di markdown inizia con > all'inizio di una riga.

> This is a single-line blockquote.

Visualizza come:

Questa è una citazione in blocco di una sola riga.

Lo spazio dopo > è facoltativo ma consigliato. Entrambi funzionano in modo identico nella maggior parte dei parser:

> With a space
>Without a space

Per la massima compatibilità, specialmente sui parser CommonMark più severi, includere sempre lo spazio.

Perché il carattere >? Markdown ha preso in prestito la sintassi delle virgolette dalle convenzioni della posta elettronica. Quando rispondi a un'e-mail, il testo citato è spesso preceduto da >. Gruber mantenne la convenzione perché era già familiare a chiunque avesse utilizzato la posta elettronica a partire dagli anni '80.


Virgolette su più righe in Markdown

Più righe nello stesso paragrafo

Aggiungi > all'inizio di ogni riga:

> This is line one of the blockquote.
> This is line two.
> This is line three.

Visualizza come un singolo paragrafo:

Questa è la prima riga del blockquote. Questa è la linea due. Questa è la riga tre.

Continuazione pigra (non consigliata)

Alcuni parser ti consentono di eliminare > sulle righe di continuazione:

> This is line one.
This is line two (lazy style).

Funziona in CommonMark e GitHub Flavored Markdown, ma alcuni parser non funzionano. Anteporre sempre a ogni riga il prefisso > per compatibilità.

Virgolette multiparagrafo

Per più paragrafi all'interno di una singola virgoletta, separali con una riga contenente 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.

Visualizza come:

Questo è il primo paragrafo della citazione.

Questo è il secondo paragrafo. Notare la riga vuota > sopra.

E questo è un terzo paragrafo.

Regola fondamentale: la riga vuota tra i paragrafi deve contenere ancora un carattere >. Senza di esso, la citazione termina e ne inizia una nuova, che di solito non è ciò che desideri.


##Blocchi di markdown nidificati

Impila i caratteri > per annidare le virgolette una dentro l'altra:

> 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.

Visualizza come:

Questa è la citazione di primo livello.

Questa è una citazione nidificata all'interno della prima.

E questo è annidato a tre livelli di profondità.

Ritorno al primo livello.

La nidificazione è comune nelle catene di risposta in stile email, dove ogni livello di > rappresenta un altro ciclo di virgolette. In pratica, andare più in profondità di due o tre livelli diventa difficile da leggere, quindi valuta la possibilità di ristrutturare il contenuto prima di annidarlo a quattro livelli di profondità.


Formattazione all'interno delle virgolette Markdown Block

Le virgolette possono contenere la maggior parte degli altri elementi di markdown. Inserisci ogni elemento su una riga separata, sempre con il prefisso >.

Formattazione del testo

> You can use **bold**, *italic*, ***bold italic***,
> ~~strikethrough~~, and `inline code` inside blockquotes.

Visualizza come:

È possibile utilizzare grassetto, corsivo, grassetto corsivo, barrato e codice in linea tra virgolette.

Intestazioni

> ### This is a heading inside a blockquote
>
> And this is regular text below it.

Visualizza come:

### Questa è un'intestazione all'interno di una citazione

E questo è il testo normale sotto di esso.

Elenchi

Funzionano sia gli elenchi ordinati che quelli non ordinati:

> **Quarterly Review:**
>
> - Revenue grew 23%
> - Headcount increased by 12
> - Customer churn dropped to 3%
>
> *All metrics are trending in the right direction.*

Visualizza come:

Revisione trimestrale:

  • I ricavi sono cresciuti del 23%
  • L'organico è aumentato di 12 unità
  • Il tasso di abbandono dei clienti è sceso al 3%

Tutti i parametri tendono nella giusta direzione.

Blocchi di codice

I blocchi di codice recintati funzionano all'interno di virgolette, ma ogni riga necessita ancora del prefisso >:

> Run the following command to install:
>
> ```bash
> npm installa markdown-it
>```
>
> Then restart your application.

Collegamenti e immagini

> For more info, visit [our documentation](https://example.com).
>
> ![Logo](https://example.com/logo.png)

Cosa non funziona in modo affidabile

  • Le tabelle all'interno di virgolette funzionano in GitHub Flavored Markdown ma falliscono con parser più severi. Prova prima di affidarti a loro.
  • Le regole orizzontali tra virgolette (---) sono ambigue e vengono visualizzate in modo incoerente.
  • Gli elementi di blocco HTML all'interno delle virgolette si comportano in modo imprevedibile tra i parser.

Avvisi GitHub (note, avvisi, suggerimenti)

GitHub Flavored Markdown (GFM) estende la sintassi dei blockquote con cinque tipi di avvisi speciali che vengono visualizzati con colori e icone distinti su GitHub, GitHub Issues, README e richieste pull.

Sintassi

> [!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.

Regole per gli avvisi GitHub

  • Il tipo di avviso ([!NOTE], [!TIP], ecc.) deve trovarsi su una riga separata all'inizio del blockquote.
  • I tipi di avviso fanno distinzione tra maiuscole e minuscole, [!note] non funzionerà.
  • L'avviso si applica all'intero blockquote che segue.
  • Solo un tipo di avviso per blockquote. I tipi di combinazione non sono supportati.

Quando utilizzare ciascun tipo

Avviso Utilizzare per
[!NOTA] Contesto utile che non è critico ma aiuta il lettore
[!TIP] Consigli facoltativi che rendono qualcosa più facile o migliore
[!IMPORTANTE] Informazioni che il lettore deve conoscere per avere successo
[!ATTENZIONE] Qualcosa che potrebbe andare storto se ignorato
[!ATTENZIONE] Rischi gravi, perdita di dati, problemi di sicurezza, azioni irreversibili

Gli avvisi GitHub funzionano nei README del repository, nelle pagine wiki, nei problemi, nelle richieste pull e nelle discussioni. Non vengono visualizzati come avvisi al di fuori di GitHub, altrove ricorrono alle normali virgolette con il testo "[!NOTE]" visibile come testo semplice.


Didascalie di ossidiana

Obsidian utilizza una sintassi simile agli avvisi di GitHub ma con molte più opzioni. La sintassi è > [!type] seguita dal contenuto:

> [!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.

Tipi di callout ossidiana

Obsidian supporta oltre una dozzina di tipi di callout, ciascuno con colori e icone distinti:

  • "nota", "informazioni", "abstract", "riepilogo", "tldr".
  • "suggerimento", "suggerimento", "importante".
  • "successo", "controllo", "fatto".
  • "domanda", "aiuto", "faq".
  • "avvertimento", "attenzione", "attenzione".
  • "fallimento", "fallimento", "mancante".
  • "pericolo", "errore".
  • "bug".
  • "esempio".
  • "citazione", "citazione".

Callout pieghevoli

Aggiungi un + o un - dopo il tipo per rendere pieghevoli i callout:

> [!note]+ Click to expand (starts open)
> Content hidden behind a toggle.

> [!warning]- Click to expand (starts closed)
> Collapsed by default.

Callout nidificati

I callout possono essere annidati proprio come le normali virgolette:

> [!note] Outer callout
> This is the outer content.
>
> > [!tip] Inner callout
> > This is nested inside.

I callout di Obsidian sono il motivo per cui molti utenti di markdown preferiscono Obsidian per prendere appunti, trasformano semplici virgolette in blocchi di informazioni ricchi e stilizzati.


Quando utilizzare le virgolette

I blockquote sono versatili. Ecco le cinque situazioni più comuni in cui li utilizzerai, con esempi per aiutarti a capire.

1. Citare qualcun altro

Lo scopo originale. Attribuisci le citazioni alla loro fonte con una riga per l'attribuzione:

> The best way to predict the future is to invent it.
>
> Alan Kay

Visualizza come:

Il modo migliore per predire il futuro è inventarlo.

Alan Kay

Stile accademico con citazione adeguata:

> 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. Inserisci le virgolette nei contenuti di lunga durata

Estrai una frase memorabile dal corpo del testo per attirare l'attenzione visiva:

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. Didascalie e note

Prima che esistessero gli avvisi di GitHub, le persone utilizzavano virgolette con etichette in grassetto per creare callout:

> **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.

Ancora ampiamente utilizzato nelle piattaforme che non supportano gli avvisi GitHub.

4. Risposte e citazioni in stile email

Nelle discussioni, nei problemi e nelle richieste pull:

> Should we use PostgreSQL or MySQL for this?

PostgreSQL, better JSON support and stronger type system.

5. Citazioni con fonti

Per scritti accademici, giornalistici o tecnici:

> 78% of developers report using markdown daily.
>
> An interesting article on markdown, 2025

Disegnare le virgolette con i CSS

Il ribasso puro non ha opzioni di stile. Le virgolette rendono comunque la piattaforma decide. La maggior parte dei renderer utilizza per impostazione predefinita un bordo sinistro, testo grigio e un po' di riempimento.

Stile personalizzato sul tuo sito

Se pubblichi markdown su un sito che controlli (Jekyll, Hugo, Ghost, Next.js e simili), sovrascrivi il 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;
}

Fallback HTML in linea

Quando hai bisogno di uno stile di virgolette specifico all'interno del markdown e la piattaforma consente HTML non elaborato:

<blockquote style="border-left: 4px solid #e74c3c; padding-left: 1em; color: #666;">
  This is a custom-styled quote.
</blockquote>

Funziona su GitHub, sulla maggior parte dei generatori di siti statici e su Ghost. Non funziona su Reddit, Discord o Slack (che rimuovono l'HTML in linea).


Compatibilità della piattaforma

Le virgolette sono una delle funzionalità di ribasso più universalmente supportate. Funzionano quasi ovunque, ma vale la pena conoscere le varianti specifiche della piattaforma.

| 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          |

Note specifiche della piattaforma

Discord supporta virgolette a riga singola e multilinea, ma non supporta la nidificazione. Utilizzare > per una riga singola o >>> all'inizio per una citazione su più righe che continua fino alla fine del messaggio.

Slack rende > come virgoletta ma non supporta la nidificazione. Le virgolette su più righe richiedono > su ogni riga.

Reddit richiede una riga vuota prima di qualsiasi virgoletta per poter essere visualizzato. Questo è il motivo più comune per cui i blockquote falliscono su Reddit.

Notion converte automaticamente l'input > nel proprio blocco Quote. Le virgolette nidificate richiedono il trascinamento dei blocchi l'uno nell'altro.

Per ulteriori peculiarità della piattaforma, consulta la nostra guida completa alla compatibilità nel cheatsheet del pilastro.


Errori comuni e correzioni

1. Blockquote non viene visualizzato

Causa: Manca una riga vuota prima o dopo la virgoletta.

Rotto:

Here is regular text.
> This should be a blockquote.
More text.

Fisso:

Here is regular text.

> This should be a blockquote.

More text.

La maggior parte dei parser perdona questo, ma quelli più severi (incluso Reddit) richiedono righe vuote su entrambi i lati.

2. La virgoletta multiparagrafo si divide in due

Causa: La riga vuota tra i paragrafi non contiene >.

Rotto:

> First paragraph.

> Second paragraph (this becomes a separate blockquote).

Fisso:

> First paragraph.
>
> Second paragraph (now part of the same blockquote).

La riga separatrice vuota deve contenere ancora >.

3. L'avviso GitHub viene visualizzato come una semplice citazione in blocco

Causa: il tag di avviso si trova sulla riga sbagliata, è errato o contiene spazi aggiuntivi.

Rotto:

> [!note]
> This is a note.

Il tipo deve essere maiuscolo:

Fisso:

> [!NOTE]
> This is a note.

Controlla anche che il tag sia su una riga separata, senza nulla dopo sulla stessa riga.

4. Le virgolette nidificate si riducono a un unico livello

Causa: Caratteri > mancanti o incoerenti nelle righe nidificate.

Rotto:

> Outer quote.
>> Nested quote.

Spazio mancante tra > e >:

Fisso:

> Outer quote.
>
> > Nested quote.

Inserisci sempre uno spazio tra ciascun carattere > durante la nidificazione e includi una riga vuota > prima della nidificazione.

5. Il blocco di codice all'interno delle virgolette si interrompe

Causa: > mancante sulle linee del recinto.

Rotto:

> Here's some code:
```javascript
console.log("ciao");```
> Back to the quote.

Fisso:

> Here's some code:
>
> ```javascript
> console.log("ciao");
>```
>
> Back to the quote.

Ogni linea, comprese le linee di recinzione, necessita del prefisso >.

6. Le righe di continuazione pigre vengono visualizzate come paragrafi regolari

Causa: il parser non supporta la continuazione lenta.

Rischioso:

> First line of the quote.
Second line without >.

Sempre al sicuro:

> First line of the quote.
> Second line with >.

Best practice per Markdown Blockquote

Le virgolette a blocchi sono una delle funzionalità di ribasso più versatili. Supportano qualsiasi cosa, dalle semplici virgolette ai richiami e avvisi complessi.

Quando qualcosa non viene visualizzato come previsto, controlla le regole di formattazione comuni sopra. La maggior parte dei problemi deriva dalla mancanza di caratteri > o da problemi di spaziatura.


Domande frequenti

Cos'è una virgoletta in blocco nel ribasso?

Una citazione in blocco è un blocco di testo visivamente separato dal contenuto circostante, solitamente con un bordo sinistro, un riempimento e talvolta testo in corsivo o disattivato. Nel markdown, qualsiasi riga che inizia con > diventa parte di una virgoletta.

Posso annidare le virgolette nel markdown?

SÌ. Aggiungi un altro > per ogni livello di nidificazione, > > per due livelli, > > > per tre e così via. Inserisci sempre uno spazio tra ogni carattere >.

Come concludo una citazione in blocco?

Lascia una riga vuota (senza >) dopo l'ultima riga tra virgolette. La riga di testo successiva sarà un paragrafo normale.

Posso inserire blocchi di codice all'interno di una virgoletta?

SÌ. Utilizza blocchi di codice recintati (tripli backtick) e anteponi ogni riga, comprese le linee di recinzione, con >.

Perché il mio avviso GitHub non viene visualizzato colorato?

Gli avvisi di GitHub vengono visualizzati solo su GitHub stesso (inclusi problemi di GitHub, richieste pull, wiki e README). Al di fuori di GitHub, ricorrono alle normali virgolette con il testo [!NOTE] visibile. Controlla anche che il tipo di avviso sia maiuscolo e su una riga separata.

Qual è la differenza tra una citazione in blocco e un callout?

Una virgoletta in blocco è un ribasso standard (>). Un callout è una variante con stile, gli avvisi GitHub e i callout Obsidian utilizzano la sintassi delle virgolette con un tag aggiuntivo ([!NOTE], [!warning]) per attivare uno stile speciale. I callout sono estensioni della piattaforma, non ribassi principali.

Come posso citare qualcuno e aggiungere attribuzioni?

Aggiungi una riga dopo la citazione con la fonte:

> Premature optimization is the root of all evil.
>
> Donald Knuth

Posso definire lo stile delle virgolette con colori personalizzati?

Non con il puro ribasso, i blockquote ereditano qualunque stile applichi la piattaforma. Su un sito che controlli, sostituisci il CSS <blockquote>. All'interno del contenuto di markdown, utilizza HTML non elaborato con stili incorporati se la piattaforma lo consente.

Le virgolette funzionano con tutti i tipi di ribasso?

SÌ. Le virgolette fanno parte delle specifiche originali di John Gruber e sono supportate da ogni parser di markdown tra cui CommonMark, GFM, MultiMarkdown, Pandoc e varianti di piattaforma come Discord, Slack e Reddit.

Perché il mio blockquote si interrompe su Reddit?

Reddit richiede una riga vuota prima di qualsiasi virgoletta. Inoltre, il markdown di Reddit è più rigido di GFM, se > non inizia all'inizio di una riga (senza spazi iniziali), non verrà visualizzato.

Posso avere una citazione vuota?

Tecnicamente sì, > sulla propria riga produce un blocco vuoto tra virgolette, ma è raramente utile. La maggior parte dei parser visualizza semplicemente un bordo sottile senza contenuto.

Quanto dovrebbe essere lungo un blockquote?

Non esiste alcun limite tecnico. Stilisticamente, le virgolette brevi (una o due frasi) funzionano bene come virgolette. Le virgolette più lunghe (un paragrafo o più) funzionano per le citazioni estese. Se una citazione dura più di qualche paragrafo, valuta invece la possibilità di parafrasare o riassumere.