Citations et notes de bas de page dans Quarto
Ajoutez une bibliographie, citez vos sources et glissez des notes de bas de page — l’essentiel pour rédiger un article
Apprenez à ajouter des citations et des notes de bas de page dans Quarto — pointez vers une bibliographie .bib, citez vos sources dans le texte par clé, choisissez un style de citation (CSL), et ajoutez des notes de bas de page en ligne et par référence. Tout ce qu’il faut pour rédiger un rapport qui se lit comme un article.
- Pointez Quarto vers un fichier
.bibavec une seule ligne d’en-tête —bibliography: references.bib— et il gère la liste des références à votre place. - Citez dans le texte avec
@key. Les crochets[@key]donnent une citation entre parenthèses ; un@keyseul l’intègre dans une phrase ;[-@key]n’affiche que l’année. - La bibliographie est générée automatiquement à partir des travaux que vous citez réellement, placée à la fin — ou là où vous déposez un div vide
::: {#refs}. - Changez de style de citation en ajoutant un fichier CSL (Citation Style Language) :
csl: nature.csl. Le style par défaut est Chicago auteur-date. - Les notes de bas de page existent sous deux formes : une note par référence
[^id]définie ailleurs, ou une note en ligne^[written right here]. Les deux sont numérotées automatiquement. - Tout est montré en fonctionnement ici : chaque citation et note de bas de page ci-dessous s’affiche juste à côté de la source exacte qui l’a produite.
Introduction
Votre analyse est terminée et il faut maintenant qu’elle se lise comme un article — des affirmations étayées par des références, une liste de références bien rangée à la fin, et l’occasionnelle remarque glissée dans une note de bas de page plutôt que d’encombrer la phrase. Retaper les citations à la main, c’est ainsi que les numéros dérivent et que les styles deviennent incohérents. Quarto le fait correctement : vous conservez vos sources dans un fichier de bibliographie, vous les citez par clé, et Quarto construit à votre place les citations formatées dans le texte et la liste des références — en renumérotant et reformatant automatiquement lorsque vous ajoutez, supprimez ou changez de style.
Comme il s’agit d’un guide de fonctionnalité Quarto, chaque exemple est auto-démonstratif — vous voyez la source, et immédiatement en dessous la citation ou la note de bas de page que Quarto a produite à partir de cette source. La référence complète des options se trouve dans la documentation des citations Quarto ; cette leçon en est le chemin pratique.
Orienter Quarto vers une bibliographie
Une citation a besoin d’un endroit où retrouver la source. Quarto lit un fichier de bibliographie — le plus souvent un fichier .bib BibTeX/BibLaTeX — que vous nommez dans l’en-tête YAML du document. Chaque entrée possède une clé avec laquelle vous la citerez.
Cette page est reliée à un references.bib placé à côté d’elle, déclaré ainsi :
---
title: "My report"
bibliography: references.bib
---Une entrée .bib ressemble à celle ci-dessous. Le jeton juste après le type d’entrée (wickham2016 ici) est la clé de citation — c’est ce que vous taperez pour la citer :
@Book{wickham2016,
title = {ggplot2: Elegant Graphics for Data Analysis},
author = {Hadley Wickham},
publisher = {Springer-Verlag New York},
year = {2016},
}Vous ne les écrivez pas à la main — Zotero, votre gestionnaire de références, ou le bouton « cite » d’une revue exportent tous du .bib. Pointez bibliography: vers le fichier et chaque clé qu’il contient devient citable. Les clés de citation doivent commencer par une lettre, un chiffre ou _, et peuvent contenir des caractères alphanumériques ainsi que quelques signes de ponctuation (:.#$%&-+?<>~/).
Citer une source dans le texte
Une citation est une clé précédée de @. Entourez-la de crochets pour une citation entre parenthèses, ou retirez les crochets pour l’intégrer à une phrase. Vous pouvez ajouter des localisateurs (numéros de page), des préfixes (« see »), et citer plusieurs travaux à la fois séparés par des points-virgules.
Voici les formes courantes — la source à gauche, la citation que Quarto rend à droite. Les trois clés (rcore2024, wickham2016, xie2015) figurent dans le references.bib de cette page.
Source :
The grammar of graphics is laid out in a dedicated book [@wickham2016].
Base R itself has a formal reference [@rcore2024; @xie2015].
@xie2015 explains how knitr executes code chunks.
The idea dates back further [see @wickham2016, pp. 33-35].
Wickham introduced the package that year [-@wickham2016].Rendu :
La grammaire des graphiques est exposée dans un ouvrage dédié (Wickham 2016).
R de base possède lui-même une référence formelle (R Core Team 2024; Xie 2015).
Xie (2015) explique comment knitr exécute les blocs de code.
L’idée remonte encore plus loin (see Wickham 2016, pp. 33-35).
Wickham a introduit le package cette année-là (2016).
Lisez les formes à partir du résultat : [@wickham2016] est une citation entre parenthèses ; [@rcore2024; @xie2015] en fusionne deux en une seule parenthèse, séparées par un point-virgule ; un @xie2015 seul devient le sujet de la phrase (« Xie (2015) explique… ») ; [see @wickham2016, pp. 33-35] ajoute un préfixe et un localisateur de page à l’intérieur des crochets ; et [-@wickham2016] supprime l’auteur pour n’afficher que l’année — exactement ce que vous voulez lorsque vous avez déjà nommé l’auteur dans la phrase.
Choisir un style de citation
Par défaut, Quarto formate les citations selon le format auteur-date du Chicago Manual of Style — c’est le style (Wickham 2016) que vous voyez ci-dessus. Pour correspondre à une revue particulière, ajoutez un fichier CSL (Citation Style Language) et nommez-le dans l’en-tête :
---
title: "My report"
bibliography: references.bib
csl: nature.csl
---Avec un style numérique comme celui de Nature, les mêmes citations s’affichent sous forme de numéros entre crochets — [1], [1,2] — et la liste des références est ordonnée en conséquence. Vous n’écrivez pas le style vous-même ; téléchargez celui qu’il vous faut depuis un dépôt de fichiers CSL prêts à l’emploi :
- Le projet CSL styles — des milliers de styles de revues.
- Le dépôt de styles de Zotero — cherchable par nom de revue.
Déposez le fichier .csl à côté de votre document, pointez csl: vers lui, et refaites le rendu — chaque citation dans le texte et toute la liste des références se reformatent d’un coup.
Générer la bibliographie
Vous n’écrivez jamais la liste des références à la main. Quarto rassemble chaque travail que vous avez cité, formate chaque entrée selon le style, et place la liste à la fin du document par défaut. Comme une liste de références a sa place sous un titre, la convention est d’ajouter un div vide portant l’id refs là où vous voulez qu’elle apparaisse :
## References
::: {#refs}
:::La liste des références de cette page — construite à partir des trois travaux cités ci-dessus — s’affiche juste ici :
Références
Cette liste a été générée, non tapée : elle contient exactement les travaux cités plus haut ((R Core Team 2024), (Wickham 2016), (Xie 2015)), formatés en Chicago auteur-date et triés pour vous. Citez une autre source et elle rejoint la liste automatiquement ; supprimez une citation et son entrée disparaît.
Pour désactiver entièrement la liste des références — pour un brouillon, ou une diapositive — ajoutez suppress-bibliography: true à l’en-tête. Quarto formate toujours les citations dans le texte mais omet la liste.
Inclure des travaux non cités
Parfois, vous voulez une entrée dans la liste des références bien que vous ne la citiez jamais dans le texte — une liste « pour aller plus loin », ou un jeu de données que vous avez utilisé mais n’avez pas référencé en prose. Utilisez le champ d’en-tête nocite. Un @* seul inclut chaque entrée du fichier .bib ; nommer des clés n’inclut que celles-ci :
---
bibliography: references.bib
nocite: |
@rcore2024, @xie2015
---Avec ce nocite, la liste des références contiendrait rcore2024 et xie2015 même si aucun des deux n’apparaissait dans une phrase. Consultez le guide Quarto sur l’inclusion d’éléments non cités pour le comportement complet.
Notes de bas de page
Une note de bas de page déplace une remarque hors de la phrase, vers le bas de la page. Quarto prend en charge la syntaxe de notes de bas de page de Pandoc, qui existe sous deux formes.
Notes par référence
Une note par référence place un marqueur [^id] dans le texte et définit la note séparément, n’importe où dans le document. L’id est une étiquette pour vous — elle n’apparaît jamais dans le résultat ; Quarto numérote les notes dans l’ordre où leurs marqueurs apparaissent.
Source :
Quarto renders through Pandoc.[^pandoc] The code is executed first.[^engine]
[^pandoc]: Pandoc is the universal document converter Quarto builds on.
[^engine]: knitr (for R) or Jupyter (for Python) runs the code chunks.Rendu :
Quarto effectue son rendu via Pandoc.1 Le code est exécuté en premier.2
Cliquez sur l’un ou l’autre des marqueurs en exposant et la page saute jusqu’à la note (faites défiler jusqu’au bas de la page pour les voir rassemblées là). Remarquez que, bien que les étiquettes soient pandoc et engine, Quarto les a affichées sous forme de numéros séquentiels — les étiquettes ne sont que de simples identifiants, la numérotation est automatique.
Notes en ligne
Lorsque la note est courte, vous n’avez pas besoin d’une définition séparée — écrivez-la en ligne avec ^[...] là même où se place le marqueur. Il n’y a pas d’étiquette à inventer ni rien à déplacer vers le bas à la main.
Source :
The bibliography is generated automatically.^[Powered by Pandoc's citeproc, which formats and sorts every entry.]Rendu :
La bibliographie est générée automatiquement.3
Les notes en ligne sont plus simples pour une ligne unique ; réservez la forme par référence aux notes plus longues, ou lorsque la même structure de note se répète. Les deux produisent un rendu identique — un exposant numéroté relié à une note au bas de la page.
Notes sur plusieurs paragraphes
Une note par référence peut contenir plus d’un paragraphe. Indentez les lignes de continuation pour montrer qu’elles appartiennent à la note :
Here is a longer note.[^long]
[^long]: The first paragraph of the note.
A second, indented paragraph is still part of the same footnote.C’est l’indentation qui maintient le second paragraphe rattaché — une ligne non indentée suivant la note démarrerait au contraire un paragraphe de corps de texte ordinaire.
Problèmes fréquents
Une citation s’affiche littéralement [@wickham2016] (ou un ? isolé) au lieu d’une référence formatée. La clé n’est pas trouvée. Vérifiez que bibliography: dans l’en-tête pointe vers le bon fichier, que le fichier contient bien une entrée portant exactement cette clé, et que la clé est orthographiée à l’identique (elles sont sensibles à la casse). Une ligne de bibliographie manquante est la cause la plus fréquente — pas de bibliography:, rien à consulter.
La liste des références n’apparaît pas. Par défaut, elle est placée tout à la fin du document, elle peut donc se trouver sous du contenu que vous n’avez pas fait défiler — ou vous avez peut-être défini suppress-bibliography: true. Pour épingler la liste à un endroit précis (sous un titre « Références »), ajoutez-y un div vide ::: {#refs} :::.
Un numéro de note de bas de page apparaît dans le désordre. La numérotation des notes suit l’ordre dans lequel les marqueurs apparaissent dans le texte, non l’ordre dans lequel vous définissez les notes. Si un numéro semble erroné, vérifiez où se situe le marqueur [^id] dans la prose — déplacer la définition ne change pas le numéro, déplacer le marqueur, si.
Questions fréquentes
Ajoutez un fichier de bibliographie à l’en-tête — bibliography: references.bib — puis citez les entrées par clé dans votre texte avec [@key] pour une citation entre parenthèses ou @key pour nommer la source dans une phrase. Quarto formate les citations dans le texte et construit la liste des références automatiquement. Tous les détails figurent dans le guide des citations Quarto.
[@key] et @key ?
[@key] produit une citation entre parenthèses — « (Wickham 2016) ». Un @key seul produit une citation dans le texte qui se lit comme le sujet de la phrase — « Wickham (2016) ». Utilisez [-@key] pour n’afficher que l’année lorsque vous avez déjà nommé l’auteur.
Ajoutez un fichier CSL (Citation Style Language) et nommez-le dans l’en-tête : csl: nature.csl. Téléchargez le style qu’il vous faut depuis le projet CSL styles ou le dépôt de styles de Zotero. Le style par défaut est Chicago auteur-date.
Pour une note courte, écrivez-la en ligne avec ^[your note here] à l’endroit où le marqueur doit apparaître. Pour une note plus longue, placez un marqueur [^id] dans le texte et définissez la note séparément sous la forme [^id]: the note text. Quarto numérote les notes de bas de page automatiquement dans l’ordre où les marqueurs apparaissent.
À la fin du document par défaut. Pour contrôler sa position, ajoutez un div vide ::: {#refs} ::: là où vous voulez la liste des références — par exemple sous un titre ## References. Définissez suppress-bibliography: true pour omettre entièrement la liste.
Tâche. Vous rédigez un rapport et voulez (1) citer une source nommée smith2020 entre parenthèses, (2) la citer à nouveau mais avec l’auteur nommé dans la phrase, et (3) glisser une courte note de bas de page clarifiant un terme. Écrivez le Markdown pour les trois, ainsi que l’unique ligne d’en-tête qui fait fonctionner les citations.
Les citations nécessitent une entrée bibliography: dans l’en-tête. Une citation entre parenthèses utilise des crochets autour du @key ; nommer l’auteur dans la phrase supprime les crochets. Une courte note de bas de page s’écrit en ligne avec ^[...].
---
bibliography: references.bib
---
The effect was replicated [@smith2020].
@smith2020 replicated the effect the following year.
We used a fixed-effects model^[Each subject is its own control.] throughout.La ligne bibliography: indique à Quarto où retrouver smith2020. [@smith2020] s’affiche comme une citation entre parenthèses ; le @smith2020 seul nomme l’auteur dans la phrase ; et ^[Each subject is its own control.] ajoute une note de bas de page en ligne numérotée. Quarto formate les trois et ajoute smith2020 à la liste des références automatiquement.
Vous citez [@jones2019] dans votre texte, mais au rendu cela apparaît comme le texte littéral [@jones2019] au lieu d’un « (Jones 2019) » formaté. Quelle en est la cause la plus probable ?
A. Vous avez oublié le titre ## References. B. La clé jones2019 n’est pas dans le fichier de bibliographie — ou aucune ligne d’en-tête bibliography: n’y pointe. C. Les notes de bas de page et les citations ne peuvent pas être utilisées dans le même document.
B. Une citation non formatée signifie que Quarto n’a pas pu résoudre la clé. Soit bibliography: n’est pas défini dans l’en-tête, soit le fichier .bib n’a aucune entrée portant exactement cette clé (sensible à la casse), soit la clé est mal orthographiée. Le titre des références (A) ne fait que positionner la liste ; il n’affecte pas la résolution d’une citation.
Conclusion
Les citations et les notes de bas de page sont les deux touches qui font qu’un document Quarto se lit comme un article, et les deux tiennent en une ligne une fois que vous les connaissez. Nommez un fichier bibliography:, citez par @key (crochets pour la parenthèse, seul pour le texte, [-@key] pour l’année seule), et Quarto formate chaque citation et construit la liste des références à votre place — commutable vers le style de n’importe quelle revue avec un fichier CSL. Les notes de bas de page sont [^id] pour une note plus longue ou ^[...] en ligne, numérotées automatiquement. Conservez vos sources dans le .bib, citez par clé, et laissez le rendu tout maintenir formaté et synchronisé.
Leçons connexes
- Tableaux dans Quarto — l’autre moitié d’un rapport de qualité article : les tableaux markdown,
kableetgtavec des légendes à références croisées. · Figures dans Quarto — légendez, dimensionnez et référencez de façon croisée les graphiques dont parlent vos citations. · Choisir un IDE — RStudio et Positron offrent la prise en charge de rédaction Quarto la plus poussée, y compris un inséreur de citations. - Pour aller plus loin : Rédiger avec Quarto — la série complète. · Science computationnelle et IA — le pilier.
Cette leçon est reproductible : chaque citation et note de bas de page de cette page a été produite par la source Quarto montrée juste au-dessus d’elle — copiez n’importe quel bloc dans votre propre document et faites-en le rendu pour reproduire ces résultats. The runtime is the judge.
Notes de bas de page
Réutilisation
Citation
@online{2026,
author = {},
title = {Citations et notes de bas de page dans Quarto},
date = {2026-07-08},
url = {https://www.datanovia.com/learn/programming/quarto/citations-and-footnotes},
langid = {fr}
}