```{mermaid}
flowchart LR
A[Hard edge] --> B(Round edge)
B --> C{Decision}
C --> D[Result one]
C --> E[Result two]
```
flowchart LR A[Hard edge] --> B(Round edge) B --> C{Decision} C --> D[Result one] C --> E[Result two]
Ce guide propose une introduction complète aux bases de Markdown dans Quarto, incluant une gamme d’options de formatage et de fonctionnalités avancées pour améliorer vos projets de documentation.
Voici ce que vous apprendrez:
Ce guide vous permet de disposer de tous les outils nécessaires pour améliorer votre documentation, la rendre accessible et la mettre en forme de manière professionnelle. Que vous compiliez un rapport technique, du matériel pédagogique ou toute autre documentation importante, la maîtrise de ces bases de Markdown améliorera significativement votre capacité à présenter des informations de manière claire et interactive.
Markdown supporte six niveaux de titres, #
représentant le niveau le plus élevé (Titre 1) et ######
le niveau le plus bas (Titre 6).
Notez que contrairement à d’autres moteurs de rendu Markdown (notamment Jupyter et GitHub), les listes dans Quarto nécessitent une ligne blanche entière au-dessus de la liste. Dans le cas contraire, la liste ne sera pas affichée sous forme de liste, mais apparaîtra comme du texte normal sur une seule ligne.
droite | Gauche | Défaut | Centre |
---|---|---|---|
12 | 12 | 12 | 12 |
123 | 123 | 123 | 123 |
1 | 1 | 1 | 1 |
Dans Quarto, les diagrammes Mermaid et Graphviz sont pris en charge en mode natif.
Éditeurs en direct pour améliorer votre productivité lors de la création de diagrammes:
Créer un organigramme avec Mermaid:
```{mermaid}
flowchart LR
A[Hard edge] --> B(Round edge)
B --> C{Decision}
C --> D[Result one]
C --> E[Result two]
```
flowchart LR A[Hard edge] --> B(Round edge) B --> C{Decision} C --> D[Result one] C --> E[Result two]
Un simple graphe non orienté créé à l’aide de graphviz:
```{dot}
graph G {
layout=neato
run -- intr;
intr -- runbl;
runbl -- run;
run -- kernel;
kernel -- zombie;
kernel -- sleep;
kernel -- runmem;
sleep -- swap;
swap -- runswap;
runswap -- new;
runswap -- runmem;
new -- runmem;
sleep -- runmem;
}
```
En savoir plus sur diagrammes dans Quarto.
Inclure une vidéo de YouTube:
Exemples supplémentaires démontrant l’utilisation de diverses sources et options vidéo:
{{< video local-video.mp4 >}}
{{< video https://www.youtube.com/embed/wo9vZccmqwc >}}
{{< video https://youtu.be/wo9vZccmqwc width="400" height="300" >}}
{{< video https://www.youtube.com/embed/wo9vZccmqwc
title="What is the CERN?"
start="116"
aspect-ratio="21x9"
>}}
En savoir plus sur videos dans Quarto.
Insérer un saut de page avec le shortcode pagebreak
:
Les sauts de page natifs sont pris en charge pour HTML, LaTeX, Context, MS Word, Open Document et ePub.
Notez qu’il existe cinq types de notices, incluant note
, tip
, warning
, caution
, and important
.
Ceci est un conseil.
Ceci est un avertissement.
Ceci est une mise en garde.
Ceci est important.
Les annotations des cellules de code impliquent:
# <2>
). Utiliser le même nombre pour étendre une annotation sur plusieurs lignes.Les positions d’annotation possibles pour la sortie HTML sont les suivantes:
below
(par défaut) : Les annotations apparaissent par défaut sous la cellule de code.hover
: Les annotations s’affichent au passage de la souris sur un marqueur de ligne.select
: Les annotations apparaissent lorsqu’on clique sur un marqueur et peuvent être supprimées en cliquant à nouveau.Pour changer la position par défaut des annotations, utilisez le champ de métadonnées code-annotations
dans l’en-tête du document: