Citazioni in Markdown: blocchi di citazione, più paragrafi ed elenchi
Scrivi citazioni Markdown con >, annidale, cita più paragrafi e distingui gli avvisi GitHub dalla sintassi portabile prima di esportare in Word.
Un blocco di citazione Markdown inizia con > seguito da uno spazio. Metti il marcatore all'inizio di ogni riga citata per mantenere il sorgente facile da leggere e modificare.
> La guida all'installazione aggiornata è pronta per la revisione.
Il risultato è un paragrafo citato, non un blocco di codice. Bordo, rientro e colore dipendono dal tema della pagina o del documento. Il testo della citazione rimane normale Markdown, quindi può contenere enfasi, collegamenti, elenchi e altre strutture del documento.
Usa il visualizzatore Markdown per provare gli esempi, quindi esporta il documento con il convertitore da Markdown a Word quando serve una copia modificabile per la revisione.
Cita un paragrafo su più righe del sorgente
Per una citazione più lunga, ripeti il marcatore:
> La guida all'installazione aggiornata è pronta per la revisione.
> Controlla i prerequisiti prima di approvare la pubblicazione.
Queste due righe del sorgente formano un solo paragrafo nell'anteprima di questo sito. Un ritorno a capo nel sorgente non impone necessariamente un'interruzione di riga visualizzata. Quando il testo deve restare su due righe, aggiungi un'interruzione esplicita:
> Revisione della documentazione\
> Assegnata al responsabile della versione
La barra inversa va prima del ritorno a capo; la riga successiva inizia ancora con il marcatore di citazione. Consulta gli a capo in Markdown per distinguere le interruzioni forzate dalle separazioni tra paragrafi.
Includi più paragrafi in una citazione
Metti un marcatore di citazione sulla riga che altrimenti sarebbe vuota tra i paragrafi:
> La prima bozza descrive la procedura di installazione.
>
> La seconda aggiunge passaggi per la risoluzione dei problemi ed esempi.
In questo modo crei un solo blocco di citazione contenente due paragrafi. Mantenere > sulla separazione rende visibile il raggruppamento previsto, soprattutto quando qualcuno modificherà il passaggio in seguito.
Per riprendere il tuo testo, lascia una riga vuota e continua senza marcatore:
> La revisione ha richiesto una sezione di installazione più breve.
Abbiamo spostato le note di configurazione dettagliate in un'appendice.
Evita di rimuovere > da una riga di continuazione senza aggiungere una riga vuota. Alcuni parser Markdown interpretano questo caso come una continuazione implicita del paragrafo citato. La specifica CommonMark dei blocchi di citazione descrive questo comportamento. Marcatori espliciti e una riga vuota ben distinta facilitano la manutenzione tra collaboratori.
Aggiungi enfasi, collegamenti e attribuzione
Il contenuto di una citazione può usare la normale formattazione in linea:
> **Nota di revisione:** I passaggi di migrazione richiedono un esempio funzionante.
> Consulta la [lista di controllo del rilascio](https://example.com/checklist).
>
> Commenti dalla revisione della documentazione, settembre 2026.
Markdown non assegna un ruolo bibliografico speciale all'ultima riga. È normale contenuto di paragrafo all'interno della citazione. Includi fonte, autore e collegamento quando sono necessari e verifica le autorizzazioni prima di riprodurre un passaggio altrui.
Un blocco di citazione non aggiunge nemmeno virgolette letterali. Inseriscile tu se il documento finale le richiede. Per una citazione breve integrata in una tua frase, le normali virgolette possono bastare senza creare un blocco separato.
Annida una citazione o includi un elenco
Usa un altro livello di > per il materiale citato all'interno della citazione esterna:
> Il revisore ha riassunto la richiesta precedente:
>
> > Aggiungi un esempio completo del file di configurazione.
>
> La bozza aggiornata ora include questo esempio.
Limita i livelli di annidamento in una relazione. Le citazioni molto annidate riducono la larghezza disponibile per il testo, rendendo potenzialmente più difficile la lettura delle impaginazioni PDF e Word.
Un elenco dentro una citazione mantiene il marcatore su ogni riga:
> La revisione ha individuato due modifiche:
>
> - Spiegare le autorizzazioni necessarie.
> - Aggiungere una sezione per la risoluzione dei problemi.
Per la struttura opposta, una citazione dentro un elenco, applica un rientro sotto il testo della voce:
- Commenti sulla documentazione
> Aggiungi una sezione per la risoluzione dei problemi prima della pubblicazione.
- Lista di controllo del rilascio
Se la citazione appare fuori dalla voce, confronta il rientro con gli esempi della guida ai rientri in Markdown.
Gli avvisi GitHub richiedono supporto nella destinazione
GitHub supporta avvisi speciali basati sulla sintassi delle citazioni, inclusa questa forma:
> [!NOTE]
> Esegui una copia di sicurezza della configurazione prima di modificarla.
GitHub documenta i tipi supportati nella guida di riferimento agli avvisi. Colori e icone degli avvisi sono funzionalità della piattaforma, non proprietà di tutte le citazioni Markdown.
Il motore di rendering di questo sito non applica lo stile degli avvisi GitHub. L'esempio rimane un blocco di citazione con l'etichetta [!NOTE] visibile. Per un documento che deve rimanere leggibile in diverse destinazioni, usa un'etichetta esplicita in grassetto:
> **Nota:** Esegui una copia di sicurezza della configurazione prima di modificarla.
Così il significato resta comprensibile senza un'estensione speciale per gli avvisi. Lo stesso approccio funziona per un avvertimento, una decisione di revisione o una nota editoriale.
Risolvi i problemi delle citazioni prima dell'esportazione
Se > appare letteralmente, controlla se l'esempio è tra accenti gravi, in un blocco di codice delimitato o in un blocco di codice rientrato. Questi contesti servono a mostrare il testo sorgente. Anche una barra inversa prima del marcatore ne esegue l'escape.
Se troppo testo viene incluso nella citazione, aggiungi una riga vuota prima del paragrafo che deve riprendere all'esterno. Se il materiale annidato è difficile da seguire, riduci l'annidamento e aggiungi l'attribuzione come paragrafo normale.
Infine, apri il DOCX esportato e controlla le citazioni lunghe e gli elenchi citati. Il bordo sinistro del browser e lo stile di paragrafo di un documento Word possono differire. Usa lo strumento da Markdown a HTML per esaminare la struttura intermedia quando devi distinguere un problema di formattazione del sorgente da un problema di stile nell'esportazione.