## Riferimento

Callout Markdown GitHub

Pubblicato marzo 2026

GitHub ha aggiunto la sintassi dei callout (avvisi) al GitHub Flavored Markdown. Questi riquadri stilizzati evidenziano informazioni importanti nella documentazione — note, suggerimenti, avvisi e altro. ShowMeMyMD è uno dei pochi visualizzatori desktop che li renderizza.


## La sintassi

Cinque tipi di callout

I callout usano la sintassi del blockquote con un tag speciale nella prima riga. Il formato è sempre lo stesso: > [!TIPO] seguito dal contenuto nella riga successiva, anch’esso preceduto da >.

> [!NOTE]
> Informazioni utili che gli utenti dovrebbero
> conoscere, anche leggendo di fretta.

NOTE — Si renderizza come un riquadro informativo blu. Usalo per contesto aggiuntivo utile ma non critico. Informazioni del tipo 'a proposito'.

> [!TIP]
> Consigli utili per fare le cose meglio
> o più facilmente.

TIP — Si renderizza come un riquadro verde di suggerimento. Usalo per buone pratiche, scorciatoie o raccomandazioni che semplificano la vita del lettore.

> [!IMPORTANT]
> Informazioni chiave che gli utenti devono
> conoscere per raggiungere il loro obiettivo.

IMPORTANT — Si renderizza come un riquadro viola di enfasi. Usalo per informazioni critiche da comprendere prima di procedere. Non \u00e8 un avviso, ma qualcosa che non puoi saltare.

> [!WARNING]
> Informazioni urgenti che richiedono attenzione
> immediata per evitare problemi.

WARNING — Si renderizza come un riquadro giallo di allerta. Usalo per potenziali problemi, insidie o cose che potrebbero andare storte se il lettore non fa attenzione.

> [!CAUTION]
> Avvertenze sui rischi o conseguenze negative
> di determinate azioni.

CAUTION — Si renderizza come un riquadro rosso di pericolo. Riservalo per operazioni irreversibili, scenari di perdita dati o azioni che potrebbero rompere qualcosa.


## Consigli d’uso

Scrivere callout efficaci

Usali con parsimonia

Troppi callout creano rumore visivo. Se tutto è importante, niente lo è. Una pagina piena di riquadri colorati abitua i lettori a ignorarli. Uno o due per sezione è di solito la quantità giusta.

Abbina il tipo alla gravità

Non usare CAUTION per un suggerimento secondario. Non usare NOTE per qualcosa che potrebbe cancellare un database. La codifica dei colori esiste per dare ai lettori un segnale istantaneo sulla gravità — rispettala.

Mantieni il contenuto conciso

I callout funzionano meglio con una o tre frasi. Se ti servono più paragrafi, l’informazione probabilmente appartiene al testo principale, non a un riquadro callout.

Puoi annidare altri elementi

Codice inline, link, grassetto e corsivo funzionano tutti all’interno dei callout. Fai precedere ogni riga da > per mantenere il contenuto nel blocco callout.


## Compatibilità

Dove vengono renderizzati i callout

StrumentoSupporto callout
GitHub (web)Completo — riquadri colorati con icone
ShowMeMyMDCompleto — callout stilizzati su desktop
Alcune estensioni VS CodeVariabile in base all’estensione
La maggior parte degli altri visualizzatoriNo — mostra un blockquote semplice
Renderer CommonMark standardNo — blockquote semplice
Parser GFM più vecchiNo — blockquote semplice

La maggior parte dei visualizzatori Markdown mostra solo un blockquote.

ShowMeMyMD renderizza il callout completo con stile — barra laterale colorata, icona e formattazione corretta — proprio come appare su GitHub. Se scrivi README o documentazione con callout, questo è uno dei pochi modi per visualizzarli in locale su Mac.


## Continua a leggere

Scopri di più su ShowMeMyMD come visualizzatore Markdown per Mac. Scopri perché gli sviluppatori lo scelgono come visualizzatore Markdown per sviluppatori. Oppure consulta il nostro cheat sheet Markdown.


Anteprima dei callout in locale

Smetti di fare push su GitHub solo per controllare come appaiono i tuoi callout. ShowMeMyMD renderizza NOTE, TIP, IMPORTANT, WARNING e CAUTION — direttamente sul tuo Mac. $2.99 sul Mac App Store.

Scarica dalMac App Store