## 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
| Strumento | Supporto callout |
|---|---|
| GitHub (web) | Completo — riquadri colorati con icone |
| ShowMeMyMD | Completo — callout stilizzati su desktop |
| Alcune estensioni VS Code | Variabile in base all’estensione |
| La maggior parte degli altri visualizzatori | No — mostra un blockquote semplice |
| Renderer CommonMark standard | No — blockquote semplice |
| Parser GFM più vecchi | No — 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