Fiche de référence Markdown : syntaxe, mise en forme et structure
Référence rapide pour Markdown : titres, listes, code, tableaux et plus encore.
Le langage Markdown est utilisé sur Wikipédia et Hugo. Il prend en charge les titres, les listes, les modifications de style de police, les images, les citations de code et les tableaux. Voici un bref résumé du formatage Markdown.
L’image ci-dessus a été produite par Flux - IA texte-image.
Markdown est un langage de balise léger que vous pouvez utiliser pour ajouter des éléments de formatage aux documents de texte brut. Ce guide offre une vue d’ensemble complète de la syntaxe Markdown la plus couramment utilisée, vous aidant à créer des documents bien structurés et visuellement attrayants.
Cet aide-mémoire fait partie du hub Outils de documentation en 2026 : Markdown, LaTeX, PDF & Flux de travail d’impression.
Titres Markdown (H1–H6)
Les titres en Markdown sont créés à l’aide du symbole dièse (#). Le nombre de dièses avant le texte du titre indique le niveau du titre.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Gras, Italique et Mise en emphase
Markdown propose plusieurs façons de mettre en emphase le texte. Vous pouvez utiliser des astérisques (*) ou des underscores (_) pour l’italique et des doubles astérisques (**) ou des doubles underscores (__) pour le gras.
Italique
*Italique* ou _italique_
Gras
**Gras** ou __gras__
Gras et Italique
***Gras et italique*** ou ___gras et italique___
Listes ordonnées et non ordonnées
Markdown prend en charge les listes ordonnées et non ordonnées.
Liste non ordonnée
- Élément 1
- Élément 2
- Sous-élément 1
- Sous-élément 2
Liste ordonnée
1. Premier élément
2. Deuxième élément
1. Sous-élément 1
2. Sous-élément 2
Liens hypertextes en Markdown
Vous pouvez créer des liens en enfermant le texte du lien entre crochets ([]) puis l’URL entre parenthèses (()).
[Texte du lien](URL)
Exemple
Visitez le [Guide Markdown](https://www.markdownguide.org/) pour plus d'informations.
Intégration d’images
Les images sont ajoutées en utilisant un point d’exclamation (!) suivi du texte alternatif entre crochets et de l’URL de l’image entre parenthèses.
Exemple
Citations et citations imbriquées
Les citations sont créées à l’aide du signe supérieur à (>).
> Ceci est une citation.
Citations imbriquées
> C'est le premier niveau de citation.
>> Ceci est une citation imbriquée.
Code en ligne et blocs de code délimités
Vous pouvez ajouter du code en ligne en l’enfermant entre des accents graves (`). Pour les blocs de code, utilisez des triples accents graves (```) avant et après le code.
Code en ligne
Utilisez `printf()` pour afficher du texte en C.
Blocs de code
```python
python def hello_world(): print("Hello, World!")
```
Pour en savoir plus sur les blocs de code en Markdown, consultez cet article séparé : Utilisation des blocs de code Markdown. L’identifiant de langage mermaid est un cas particulier notable — il déclenche le rendu de diagrammes plutôt que la coloration syntaxique, transformant un bloc délimité standard en organigramme ou diagramme de séquence. Le Guide de démarrage rapide des diagrammes Mermaid couvre la syntaxe complète des diagrammes, des organigrammes aux diagrammes ER.
Règles horizontales (Séparateurs)
Les règles horizontales sont créées à l’aide de trois traits d’union ou plus (—), d’astérisques (***) ou d’underscores (___).
---
Tableaux
Les tableaux en Markdown sont créés à l’aide de barres verticales (|) et de traits d’union (-).
Exemple
| En-tête 1 | En-tête 2 |
|-----------|-----------|
| Cellule 1 | Cellule 2 |
| Cellule 3 | Cellule 4 |
Pour les options d’alignement, le formatage multi-colonnes et les fonctionnalités spécifiques à GFM, consultez le Guide complet des tableaux en Markdown.
Listes de tâches (Cases à cocher)
Les listes de tâches sont un type spécial de liste qui vous permet de créer des cases à cocher.
Exemple
- [x] Tâche terminée
- [ ] Tâche en cours
Texte barré
Le texte barré est créé à l’aide de doubles tilde (~~).
~~Ce texte est barré.~~
Surlignage de texte
Le surlignage de texte n’est pas nativement supporté en Markdown, mais certains moteurs de rendu le prennent en charge en utilisant la syntaxe ==.
Exemple
==Ce texte est surligné.==
Indices et Exposants
Les indices sont créés à l’aide d’un caret (^) avant le texte, et les exposants sont créés à l’aide d’un tilde (~) avant le texte.
Exemple
H~2~O est l'eau.
E = mc^2
Équations mathématiques (Syntaxe LaTeX)
Les équations mathématiques peuvent être ajoutées en utilisant la syntaxe LaTeX entre des signes dollar ($).
Exemple
$$ E = mc^2 $$
Échappement des caractères spéciaux
Pour échapper les caractères spéciaux, utilisez une barre oblique inverse ().
Exemple
\*Italique\* ou \_italique\_
Cet aide-mémoire complet couvre la syntaxe Markdown essentielle dont vous avez besoin pour créer des documents bien formatés. Pour des fonctionnalités plus avancées et des personnalisations, consultez la documentation spécifique du moteur de rendu ou des ressources supplémentaires. Si vous utilisez Hugo, l’Aide-mémoire des commandes Hugo est une référence pratique.
Markdown est également le format de stockage par défaut pour les wikis auto-hébergés et les systèmes de connaissances. DokuWiki utilise une approche de texte brut compatible Markdown pour les bases de connaissances personnelles et d’équipe. Pour les systèmes de connaissances assistés par IA basés sur des pages Markdown, LLM Wiki explique pourquoi la portabilité et la facilité de comparaison (diff) de ce format en font la fondation idéale pour les connaissances compilées.
