Citations Markdown : citations en bloc, paragraphes multiples et listes
Écrivez des citations Markdown avec >, imbriquez-les, citez plusieurs paragraphes et distinguez les alertes GitHub de la syntaxe portable avant l'export Word.
Une citation en bloc Markdown commence par > suivi d'une espace. Placez ce marqueur au début de chaque ligne citée pour garder une source facile à lire et à modifier.
> Le guide d'installation révisé est prêt pour la relecture.
Le résultat est un paragraphe cité, pas un bloc de code. Sa bordure, son retrait et sa couleur dépendent du thème de la page ou du document. Le texte de la citation reste du Markdown ordinaire : il peut donc contenir de l'emphase, des liens, des listes et d'autres structures de document.
Utilisez la visionneuse Markdown pour essayer les exemples, puis exportez le document avec le convertisseur Markdown vers Word lorsqu'une copie modifiable est nécessaire pour la relecture.
Citer un paragraphe sur plusieurs lignes source
Pour une citation plus longue, répétez le marqueur :
> Le guide d'installation révisé est prêt pour la relecture.
> Veuillez vérifier les prérequis avant d'approuver la publication.
Ces deux lignes source forment un seul paragraphe dans l'aperçu de ce site. Un retour dans la source n'impose pas nécessairement un saut de ligne à l'affichage. Lorsque le texte doit rester sur deux lignes, ajoutez un saut explicite :
> Relecture de la documentation\
> Attribuée à la personne responsable de la version
La barre oblique inverse se place avant le retour à la ligne ; la ligne suivante commence toujours par le marqueur de citation. Consultez les sauts de ligne Markdown pour comprendre la différence entre sauts forcés et séparations de paragraphes.
Inclure plusieurs paragraphes dans une citation
Placez un marqueur de citation sur la ligne qui serait autrement vide entre les paragraphes :
> Le premier brouillon décrit la procédure d'installation.
>
> Le deuxième ajoute des étapes de dépannage et des exemples.
Cela crée une seule citation en bloc contenant deux paragraphes. Conserver > sur la séparation rend le regroupement prévu visible, notamment lorsqu'une autre personne modifie ensuite le passage.
Pour reprendre votre propre texte, laissez une ligne vide et continuez sans le marqueur :
> La relecture a demandé une section d'installation plus courte.
Nous avons déplacé les notes de configuration détaillées dans une annexe.
Évitez de retirer > d'une ligne de continuation sans ajouter de ligne vide. Certains analyseurs Markdown y voient une continuation implicite du paragraphe cité. La spécification CommonMark des citations en bloc décrit ce comportement. Des marqueurs explicites et une ligne vide bien distincte facilitent la maintenance entre collaborateurs.
Ajouter de l'emphase, des liens et une attribution
Le contenu d'une citation peut utiliser la mise en forme en ligne habituelle :
> **Note de relecture :** Les étapes de migration nécessitent un exemple fonctionnel.
> Consultez la [liste de vérification de la version](https://example.com/checklist).
>
> Commentaires de la relecture de documentation, septembre 2026.
Markdown n'attribue pas de rôle bibliographique particulier à la dernière ligne. C'est un contenu de paragraphe ordinaire à l'intérieur de la citation. Incluez la source, l'auteur et le lien lorsque c'est nécessaire, et vérifiez les autorisations avant de reproduire le passage d'une autre personne.
Une citation en bloc n'ajoute pas non plus de guillemets littéraux. Saisissez-les vous-même si le document final l'exige. Pour une courte citation intégrée dans votre propre phrase, de simples guillemets peuvent suffire sans créer de bloc séparé.
Imbriquer une citation ou inclure une liste
Utilisez un niveau supplémentaire de > pour un passage cité à l'intérieur de la citation principale :
> La personne chargée de la relecture a résumé la demande précédente :
>
> > Ajouter un exemple complet du fichier de configuration.
>
> Le brouillon mis à jour comprend désormais cet exemple.
Limitez les niveaux d'imbrication dans un rapport. Des citations très imbriquées réduisent la largeur disponible pour le texte, ce qui peut rendre les mises en page PDF et Word plus difficiles à lire.
Une liste à l'intérieur d'une citation conserve le marqueur sur chaque ligne :
> La relecture a identifié deux modifications :
>
> - Expliquer les autorisations nécessaires.
> - Ajouter une section de dépannage.
Pour la structure inverse, une citation à l'intérieur d'une liste, indentez-la sous le texte de l'élément :
- Commentaires sur la documentation
> Ajouter une section de dépannage avant la publication.
- Liste de vérification de la version
Si la citation apparaît en dehors de l'élément, comparez son indentation aux exemples du guide de l'indentation Markdown.
Les alertes GitHub nécessitent une prise en charge à destination
GitHub prend en charge des alertes spéciales fondées sur la syntaxe des citations, notamment cette forme :
> [!NOTE]
> Sauvegardez la configuration avant de la modifier.
GitHub documente les types pris en charge dans sa référence des alertes. Les couleurs et les icônes des alertes sont des fonctionnalités de la plateforme, pas des propriétés de toutes les citations Markdown.
Le moteur de rendu de ce site n'applique pas le style d'alerte de GitHub. L'exemple reste une citation en bloc avec le libellé [!NOTE] visible. Pour un document qui doit rester lisible sur différentes destinations, utilisez un libellé explicite en gras :
> **Remarque :** Sauvegardez la configuration avant de la modifier.
Le sens reste ainsi compréhensible sans extension spéciale d'alerte. La même approche convient à un avertissement, une décision de relecture ou une note éditoriale.
Résoudre les problèmes de citations avant l'export
Si > apparaît littéralement, vérifiez si l'exemple est entre accents graves, dans un bloc de code délimité ou dans un bloc de code indenté. Ces contextes servent à afficher le texte source. Une barre oblique inverse avant le marqueur l'échappe également.
Si trop de texte devient cité, ajoutez une ligne vide avant le paragraphe qui doit reprendre hors de la citation. Si le contenu imbriqué est difficile à suivre, réduisez l'imbrication et ajoutez l'attribution dans un paragraphe ordinaire.
Enfin, ouvrez le DOCX exporté et examinez les longues citations et les listes citées. La bordure gauche affichée par le navigateur et le style de paragraphe d'un document Word peuvent différer. Utilisez l'outil Markdown vers HTML pour examiner la structure intermédiaire lorsque vous devez distinguer un problème de mise en forme de la source d'un problème de style à l'export.