## Référence

Callouts Markdown GitHub

Publié en mars 2026

GitHub a ajouté la syntaxe de callouts (alertes) au GitHub Flavored Markdown. Ces encadrés stylisés mettent en valeur les informations importantes dans la documentation — notes, astuces, avertissements et plus encore. ShowMeMyMD est l’un des rares lecteurs de bureau qui les rend.

## La syntaxe

Cinq types de callouts

Les callouts utilisent la syntaxe de citation avec un tag spécial sur la première ligne. Le format est toujours le même : > [!TYPE] suivi de votre contenu sur la ligne suivante, également préfixé par >.

> [!NOTE]
> Informations utiles que les utilisateurs
> devraient connaître, même en survolant le contenu.

NOTE — S'affiche sous forme d'encadré bleu d'information. Utilisez-le pour du contexte supplémentaire utile mais non critique. Pensez à des informations « au fait ».

> [!TIP]
> Conseils utiles pour faire les choses
> mieux ou plus facilement.

TIP — S'affiche sous forme d'encadré vert de suggestion. Utilisez-le pour les bonnes pratiques, raccourcis ou recommandations qui facilitent la vie du lecteur.

> [!IMPORTANT]
> Informations clés que les utilisateurs doivent
> connaître pour atteindre leur objectif.

IMPORTANT — S'affiche sous forme d'encadré violet d'emphase. Utilisez-le pour les informations essentielles à comprendre avant de continuer. Ce n'est pas un avertissement, mais quelque chose qu'on ne peut pas ignorer.

> [!WARNING]
> Information urgente nécessitant l'attention
> immédiate de l'utilisateur pour éviter des problèmes.

WARNING — S'affiche sous forme d'encadré jaune d'alerte. Utilisez-le pour les problèmes potentiels, les pièges ou les choses qui pourraient mal tourner si le lecteur n'est pas attentif.

> [!CAUTION]
> Informe sur les risques ou conséquences
> négatives de certaines actions.

CAUTION — S'affiche sous forme d'encadré rouge de danger. Réservez-le aux opérations irréversibles, aux scénarios de perte de données ou aux actions qui pourraient casser quelque chose.

## Conseils d’utilisation

Rédiger des callouts efficaces

Utilisez-les avec parcimonie

Trop de callouts créent du bruit visuel. Si tout est important, rien ne l’est. Une page remplie d’encadrés colorés entraîne les lecteurs à les ignorer. Un ou deux par section est généralement la bonne quantité.

Adaptez le type à la gravité

N’utilisez pas CAUTION pour une astuce mineure. N’utilisez pas NOTE pour quelque chose qui pourrait supprimer une base de données. Le code couleur existe pour donner aux lecteurs un signal instantané sur la gravité — respectez-le.

Restez concis

Les callouts fonctionnent mieux avec une à trois phrases. Si vous avez besoin de plusieurs paragraphes, l’information devrait probablement se trouver dans le corps du texte principal, pas dans un encadré.

Vous pouvez imbriquer d’autres éléments

Les fragments de code, les liens, le gras et l’italique fonctionnent tous à l’intérieur des callouts. Préfixez chaque ligne avec > pour garder le contenu dans le bloc callout.

## Compatibilité

Où les callouts s’affichent

Outil	Support des callouts
GitHub (web)	Complet — encadrés colorés avec icônes
ShowMeMyMD	Complet — callouts stylisés sur bureau
Certaines extensions VS Code	Variable selon l’extension
La plupart des autres lecteurs Markdown	Non — affiche une simple citation
Moteurs de rendu CommonMark standard	Non — simple citation
Anciens parseurs GFM	Non — simple citation

La plupart des lecteurs Markdown n’affichent qu’une simple citation.

ShowMeMyMD rend le callout stylisé complet — barre latérale colorée, icône et formatage approprié — exactement comme il apparaît sur GitHub. Si vous écrivez des README ou de la documentation avec des callouts, c’est l’un des rares moyens de les prévisualiser localement sur Mac.

## Continuer la lecture

En savoir plus sur ShowMeMyMD comme lecteur Markdown pour Mac. Découvrez pourquoi les développeurs le choisissent comme leur lecteur Markdown pour développeurs. Ou gardez notre aide-mémoire Markdown sous la main.

Prévisualisez les callouts localement

Arrêtez de pousser sur GitHub juste pour vérifier le rendu de vos callouts. ShowMeMyMD rend NOTE, TIP, IMPORTANT, WARNING et CAUTION — directement sur votre Mac. $2.99 sur le Mac App Store.