Les bases du Markdown dans Quarto : texte, titres, listes, liens et code

Q: Quel type de Markdown Quarto utilise-t-il ?

Quarto utilise le Pandoc Markdown, un sur-ensemble du Markdown standard. Tout ce que vous connaissez du Markdown de GitHub fonctionne, plus des extras comme les listes de définitions, les exposants/indices (^2^, ~2~), les attributs entre accolades et les citations. La référence complète est la page Quarto Markdown Basics.

Q: Comment mettre du texte en gras ou en italique dans Quarto ?

Entourez-le d’astérisques : *italic* pour de l’italique, **bold** pour du gras, et ***both*** pour du gras italique. Les tirets bas (_italic_) fonctionnent aussi. Pour un style à chasse fixe/code dans le texte, utilisez des accents graves simples : `code`.

La syntaxe Markdown qui compose tout document Quarto.

Apprenez les bases du Markdown d’un document Quarto — titres, mise en forme, listes, liens et images, blocs de citation, code en ligne et en bloc, et expressions R en ligne. Chaque élément est présenté sous forme de source à côté de son résultat rendu.

Date de publication

8 juillet 2026

Modifié

9 juillet 2026

Points clés

Le Markdown est la couche de texte d’un document Quarto — vous écrivez du texte brut avec quelques signes de ponctuation, et Quarto le transforme en une page mise en forme.
Les titres (# à ######) construisent le plan du document et alimentent la table des matières ; la mise en forme se fait avec *italic*, **bold** et `code`.
Les listes ont besoin d’une ligne vide au-dessus d’elles, -/* pour les puces et 1. pour les numéros, avec une indentation pour l’imbrication.
Les liens et les images partagent une même syntaxe — [text](url) pour un lien, ![alt](path) pour une image (le ! initial est la seule différence).
Les expressions `r ` en ligne insèrent une valeur calculée en direct dans une phrase, de sorte que votre texte ne se désynchronise jamais de votre analyse.
Tout est montré en fonctionnement ici : chaque élément est rendu juste en dessous de la source exacte qui l’a produit — copiez n’importe quel bloc et exécutez-le.

Introduction

Tout document Quarto est écrit en Markdown — un petit ensemble de conventions en texte brut qui deviennent des titres, du texte en gras, des listes et des liens au moment du rendu. Vous ne quittez pas l’éditeur de texte pour mettre en forme un rapport : vous tapez **important** et cela ressort en important. Maîtrisez la poignée de signes de cette page et vous pourrez écrire n’importe quel .qmd sans recourir à un menu.

Quarto utilise le Pandoc Markdown, un sur-ensemble du Markdown simple que vous connaissez peut-être de GitHub, avec quelques extras (listes de définitions, exposants/indices, attributs). La référence complète se trouve dans la documentation Quarto Markdown Basics ; cette leçon est le chemin pratique à travers les éléments que vous utilisez dans presque tous les documents.

Comme il s’agit d’un guide des fonctionnalités de Quarto, chaque exemple est auto-démonstratif — vous voyez la source, et immédiatement en dessous le résultat que Quarto a produit à partir de cette source. Lisez la source, regardez le rendu, et vous avez appris l’élément.

Titres

Les titres structurent un document. Commencez une ligne par un à six caractères # : un seul # est un titre de premier niveau (<h1>), ###### est le plus petit (<h6>). Quarto construit la table des matières et les ancres de section à partir de ceux-ci, alors utilisez-les dans l’ordre — ne sautez pas de # à ### juste pour obtenir une taille plus petite.

Source :

# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4

S’affiche comme un plan imbriqué — les mêmes titres qui ont produit la liste « Sur cette page » à droite de cette leçon. (Les propres sections ## de cette page, comme « Titres » ci-dessus, utilisent exactement cette syntaxe.)

Vous écrivez rarement un titre de niveau 1 # dans le corps : Quarto le réserve au title du document dans l’en-tête YAML. Vos sections commencent à ##.

Emphase et mise en forme en ligne

Entourez le texte de signes de ponctuation pour le mettre en emphase. Les trois auxquels vous recourez constamment sont l’italique, le gras et le code en ligne.

Source :

This is *italic*, this is **bold**, and this is `inline code`.

You can also ~~strike through~~ text, and write H~2~O or E = mc^2^.

S’affiche comme :

Ceci est en italique, ceci est en gras, et ceci est du inline code.

Vous pouvez aussi ~~barrer~~ du texte, et écrire H₂O ou E = mc².

Utilisez *single asterisks* (ou des tirets bas) pour de l’italique, **double** pour du gras, et des accents graves pour `inline code` — le dernier s’affiche dans une police à chasse fixe et sert à désigner un nom de fonction ou de variable dans le texte sans que Quarto essaie de l’interpréter. Les signes ~~, ~ et ^ donnent le barré, l’indice et l’exposant — des extensions Pandoc que Quarto active par défaut.

Listes

Le Markdown propose deux types de listes, et toutes deux partagent une règle qui déroute les débutants : il doit y avoir une ligne vide avant la liste. Sans elle, Quarto lit les lignes comme un seul paragraphe continu.

Listes à puces

Commencez chaque élément par -, * ou +. Indentez de quatre espaces (ou d’une tabulation) pour imbriquer une sous-liste.

Source :

- First item
- Second item
    - A nested item
    - Another nested item
- Third item

S’affiche comme :

Premier élément
Deuxième élément
- Un élément imbriqué
- Un autre élément imbriqué
Troisième élément

Listes numérotées

Commencez chaque élément par un numéro et un point. Vous n’êtes pas obligé de garder les numéros dans l’ordre — Markdown les renumérote pour vous — mais le premier numéro définit le début de la liste.

Source :

1. Load the data
2. Fit the model
3. Report the result

S’affiche comme :

Charger les données
Ajuster le modèle
Rapporter le résultat

Note

La ligne vide au-dessus d’une liste est obligatoire dans Quarto (contrairement à GitHub ou au Markdown de Jupyter). Si une liste s’affiche comme un seul paragraphe plat, l’absence d’une ligne vide au-dessus est presque toujours la cause — voir la documentation sur les listes.

Liens et images

Les liens et les images utilisent presque la même syntaxe — la seule différence est un ! au début pour une image.

Liens

Écrivez le texte visible entre crochets, l’URL entre parenthèses juste après.

Source :

Read the [Quarto documentation](https://quarto.org) for the full reference.

S’affiche comme :

Consultez la documentation Quarto pour la référence complète.

Pour créer un lien vers une autre page de votre projet, pointez vers le fichier source — Quarto le résout vers le bon chemin rendu et vous avertit si la cible n’existe pas :

See the [tables lesson](tables.qmd) for the next step.

Images

Ajoutez un ! devant et le « texte » devient le texte alternatif — la description que les lecteurs d’écran annoncent et que les moteurs de recherche indexent, alors rédigez-en une vraie, pas image1.

Source :

![A scatterplot of engine weight against fuel economy](figures/mpg.png)

Cela affiche une image avec le texte alternatif attaché. Vous pouvez aussi ajouter un attribut entre accolades pour la dimensionner — ![alt](img.png){width=400} — ce qui garde la mise en page stable. Les images et leur légende sont traitées en détail dans la leçon sur les figures.

Blocs de citation

Préfixez une ligne par > pour la citer. Quarto l’affiche comme un bloc indenté et détaché — utile pour une citation mise en avant ou une note tirée d’une source.

Source :

> Reproducibility is not a feature you add at the end;
> it is a property of how you write the document.

S’affiche comme :

La reproductibilité n’est pas une fonctionnalité que l’on ajoute à la fin ; c’est une propriété de la façon dont vous écrivez le document.

Code : en ligne, en blocs et valeurs calculées

Le code apparaît de trois façons dans un document Quarto, et il vaut la peine de bien les distinguer.

Code en ligne (mise en forme uniquement)

Les accents graves simples affichent le texte dans une police à chasse fixe sans l’exécuter. Utilisez-les pour nommer une fonction ou un package dans une phrase.

Source :

Call `mean()` on the `mpg` column.

S’affiche comme :

Appelez mean() sur la colonne mpg.

Blocs de code délimités (affichage uniquement)

Trois accents graves suivis d’un nom de langage affichent un bloc avec coloration syntaxique qui ne s’exécute pas — c’est pour montrer du code que vous voulez que le lecteur lise, pas qu’il exécute. Chaque bloc source de cette page en est un.

Source :

```r
model <- lm(mpg ~ wt, data = mtcars)
summary(model)
```

S’affiche comme :

model <- lm(mpg ~ wt, data = mtcars)
summary(model)

L’enveloppe à quatre accents graves dans la source ci-dessus est la façon de montrer un bloc à trois accents graves littéralement — la clôture extérieure a plus d’accents graves que la clôture intérieure, donc Pandoc affiche la clôture intérieure au lieu de l’interpréter.

Cellules de code exécutables (la partie reproductible)

Entourez le nom du langage d’accolades — ```{r} — et Quarto exécute le code au moment du rendu et insère le résultat. C’est ce qui rend un document Quarto reproductible : la sortie ci-dessous est réelle, calculée lorsque cette page a été construite, pas saisie à la main.

Le bloc ci-dessous utilise #| echo: fenced, qui affiche la propre clôture et la source de la cellule et l’exécute, de sorte que vous voyez exactement ce qui a produit la sortie :

```{r}
model <- lm(mpg ~ wt, data = mtcars)
coef(model)
```

(Intercept)          wt 
  37.285126   -5.344472

Les deux nombres ci-dessus sont l’ordonnée à l’origine et la pente ajustées d’une régression de la consommation de carburant sur le poids — calculées à partir du jeu de données intégré mtcars lors du rendu de la page. Changez le modèle et refaites le rendu, et les nombres changent avec lui. L’exécution du code fait l’objet du reste de cette série ; ici, le seul point important est la syntaxe : les accolades signifient exécuter, l’absence d’accolades signifie afficher.

Expressions R en ligne

L’astuce la plus utile pour garder un texte honnête est l’expression en ligne : `r ...` insère une valeur calculée directement dans une phrase. Écrivez le nombre une seule fois, dans le code, et il ne pourra jamais contredire votre analyse.

Source :

The dataset has `r nrow(mtcars)` cars,
averaging `r round(mean(mtcars$mpg), 1)` mpg.

S’affiche comme :

Le jeu de données contient 32 voitures, avec une moyenne de 20.1 mpg.

Les deux valeurs ont été calculées à partir de mtcars lors du rendu de la page — le nombre de lignes et la moyenne sont une sortie réelle, pas des valeurs saisies. Si les données changeaient, la phrase se mettrait à jour au rendu suivant. C’est le même principe qu’une cellule exécutable, réduit à une seule valeur au sein du texte courant ; la documentation sur le code en ligne en couvre les détails.

Commentaires et échappement

Deux petits signes complètent la rédaction au quotidien.

Commentaires — entourez le texte de  et il reste dans la source mais ne s’affiche jamais. Utilisez-les pour vous laisser une note ou pour masquer un paragraphe sans le supprimer.
Échappement — placez une barre oblique inverse devant un caractère Markdown pour l’afficher littéralement : \*not italic\* s’affiche comme *not italic*, et \$ affiche un vrai symbole dollar au lieu de démarrer une expression mathématique.

Problèmes fréquents

Une liste s’affiche comme un seul long paragraphe. Il n’y a pas de ligne vide au-dessus de la liste. Quarto (suivant Pandoc) exige une ligne vide entre un paragraphe et la liste qui le suit ; ajoutez-la et les éléments se séparent.

Un bloc exécutable affiche son code mais aucune sortie — ou l’inverse. Vérifiez les accolades et la clôture. ```{r} (accolades) exécute le code ; ```r (sans accolades) ne fait que l’afficher. Un bloc qui montre la source mais aucun résultat n’a presque toujours pas les accolades ; un bloc qui s’exécute mais masque le code a #| echo: false défini.

Le texte entre deux signes $ se transforme en formule mathématique en italique. Un $ seul démarre une expression mathématique LaTeX en ligne. Si vous voulez un montant en dollars littéral, échappez-le en \$ (ou \$5 to \$10), et l’analyseur mathématique le laisse tranquille.

Questions fréquentes

Quel type de Markdown Quarto utilise-t-il ?

Quarto utilise le Pandoc Markdown, un sur-ensemble du Markdown standard. Tout ce que vous connaissez du Markdown de GitHub fonctionne, plus des extras comme les listes de définitions, les exposants/indices (^2^, ~2~), les attributs entre accolades et les citations. La référence complète est la page Quarto Markdown Basics.

Comment mettre du texte en gras ou en italique dans Quarto ?

Entourez-le d’astérisques : *italic* pour de l’italique, **bold** pour du gras, et ***both*** pour du gras italique. Les tirets bas (_italic_) fonctionnent aussi. Pour un style à chasse fixe/code dans le texte, utilisez des accents graves simples : `code`.

Pourquoi ma liste ne s’affiche-t-elle pas comme une liste ?

La cause la plus fréquente est une ligne vide manquante. Quarto exige une ligne vide entre un paragraphe et la liste située en dessous ; sans elle, l’ensemble s’effondre en un seul paragraphe. Ajoutez la ligne vide et vérifiez que chaque élément commence par -, *, + ou 1..

Quelle est la différence entre ```r et ```{r} dans Quarto ?

```r (sans accolades) est un simple bloc délimité — il affiche du code avec coloration syntaxique qui n’est pas exécuté. ```{r} (avec accolades) est une cellule de code exécutable : Quarto l’exécute au moment du rendu et insère le résultat. Utilisez le premier pour montrer du code, le second pour calculer une sortie.

Comment insérer une valeur calculée dans une phrase ?

Utilisez une expression en ligne : `r mean(x)` dans votre texte exécute le code R et affiche la valeur dans le texte. Elle garde les nombres écrits synchronisés avec votre analyse — vous ne retapez jamais un chiffre qui pourrait devenir obsolète. Voir la documentation sur le code en ligne.

Testez vos connaissances

Tâche. Vous rédigez le paragraphe de résultats d’un rapport et voulez que la phrase « L’échantillon contient N patients, avec un âge moyen de M ans » remplisse N et M automatiquement à partir d’un data frame appelé patients (les colonnes incluent age). Écrivez la phrase Markdown en utilisant des expressions en ligne.

Indice

Vous avez besoin de deux expressions en ligne dans une seule phrase. Chacune est `r ` suivie du code R et d’un accent grave de fermeture. nrow() compte les lignes ; mean() (arrondie) donne la moyenne.

Solution

The sample contains `r nrow(patients)` patients,
with a mean age of `r round(mean(patients$age), 1)` years.

Chaque expression `r ` s’exécute lorsque le document est rendu, de sorte que le décompte et la moyenne correspondent toujours aux données actuelles — si une ligne est ajoutée, la phrase se met à jour au rendu suivant sans modification manuelle.

Vérification rapide

Vous écrivez cette ligne sans ligne vide au-dessus, directement sous un paragraphe :

Some text.
- item one
- item two

Qu’affiche Quarto ?

A. Une liste à puces avec deux éléments. B. Un seul paragraphe affichant « Some text. - item one - item two » (pas de liste). C. Une erreur qui interrompt le rendu.

Afficher la réponse

B. Quarto exige une ligne vide entre un paragraphe et une liste qui suit. Sans elle, les lignes fusionnent en un seul paragraphe et les marqueurs - apparaissent comme du texte littéral. Insérez une ligne vide après « Some text. » et la liste s’affiche correctement.

Conclusion

Le Markdown est la couche dans laquelle vous écrivez tous les jours : les titres pour la structure, * et ** pour la mise en emphase, -/1. pour les listes, [text](url) et ![alt](path) pour les liens et les images, > pour les citations et les accents graves pour le code. La règle unique qui épargne le plus de débogage est la ligne vide au-dessus d’une liste. Ajoutez la cellule exécutable ```{r} et l’expression `r ` en ligne, et votre texte cesse d’être une description statique d’une analyse pour être généré à partir d’elle. À partir d’ici, le reste de la série s’appuie sur cette base — tableaux, figures et références croisées.

Leçons connexes

Les tableaux dans Quarto — orientez les mêmes compétences Markdown vers les tableaux pipe, kable() et gt. · Les figures dans Quarto — légendez, dimensionnez et référencez de façon croisée les images que vous liez ici. · Choisir un IDE — RStudio et Positron offrent un aperçu Markdown en direct pendant que vous tapez. · Les bases de Git pour les data scientists — versionnez le .qmd, pas la sortie rendue.
Aller plus loin : Rédiger avec Quarto — la série complète. · Science computationnelle et IA — le pilier.

Cette page vous a-t-elle été utile ?

Note

Cette leçon est reproductible : chaque résultat rendu sur cette page a été produit par la source affichée juste au-dessus — copiez n’importe quel bloc et exécutez-le pour les reproduire. The runtime is the judge.

Réutilisation

CC BY-NC-SA 4.0

Citation

BibTeX

@online{2026,
  author = {},
  title = {Les bases du Markdown dans Quarto : texte, titres, listes,
    liens et code},
  date = {2026-07-08},
  url = {https://www.datanovia.com/learn/programming/quarto/markdown-basics},
  langid = {fr}
}

Veuillez citer ce travail comme suit :

“Les bases du Markdown dans Quarto : texte, titres, listes, liens et code.” 2026. July 8. https://www.datanovia.com/learn/programming/quarto/markdown-basics.