Syntaxe Markdown : l'aide-mémoire

Toute la syntaxe Markdown sur une page — les bases de la spécification d'origine, les extensions GitHub-Flavored et les extras utilisés dans la documentation moderne. Copiez n'importe quel exemple dans l'éditeur pour le voir rendu en direct.

Essayer dans l'éditeur

Gratuit · sans inscription · fonctionne dans votre navigateur, rien n'est envoyé

Markdown Viewer en disposition côte à côte : source Markdown à gauche, aperçu rendu façon GitHub à droite — Disposition côte à côte — la source et l'aperçu rendu l'un à côté de l'autre, avec défilement synchronisé ligne par ligne.

Syntaxe de base

Markdown	Rendu	Notes
`# Titre 1`	Titre 1	Jusqu'à six niveaux : `######`
`## Titre 2`	Titre 2	Un espace après `#` est obligatoire
`gras`	gras	ou `__gras__`
`italique`	italique	ou `_italique_`
`*gras italique*`	*gras italique*
`~~barré~~`	~~barré~~	GFM
`code inline`	`code inline`	Utilisez deux accents graves pour inclure un accent grave
`> citation`	citation	Imbriquez avec `> >`
`---`		Ligne horizontale ; aussi `***`
`ligne un\`	saut de ligne	Une barre oblique inverse finale ou deux espaces forcent un `<br>`
`\pas italique\`	pas italique	La barre oblique inverse échappe toute ponctuation

Liens et images

Markdown	Rendu	Notes
`[texte](https://example.com)`	texte	Lien inline
`[texte](https://example.com "Titre")`	texte	Titre optionnel, affiché au survol
`<https://example.com>`	https://example.com	Lien automatique ; les URL nues sont aussi liées en GFM
`[texte][ref] … [ref]: https://example.com`	texte	Lien par référence, défini n'importe où
`[Titre 2](#titre-2)`	Titre 2	Ancre : minuscules, espaces → tirets
`![texte alternatif](image.png)`	une image	Ajoutez `"Titre"` après l'URL pour une infobulle
`[![alt](img.png)](https://link)`	une image cliquable	Image dans un lien

Listes

Markdown	Rendu	Notes
`- élément - élément`	élément élément	`*` et `+` fonctionnent aussi
`1. premier 2. second`	premier second	Les numéros n'ont pas besoin d'être séquentiels
`- élément - imbriqué`	élément imbriqué	Indentez de 2 à 4 espaces pour imbriquer
`- [ ] à faire - [x] fait`	☐ à faire ☑ fait	Liste de tâches (GFM)
`1. étape paragraphe`	un élément de liste avec deux paragraphes	Indentez les lignes de continuation au niveau du texte

Mettez une ligne vide avant une liste qui suit un paragraphe, sinon certains moteurs la traitent comme partie du paragraphe.

Tableaux

| Gauche | Centre | Droite |
| :--- | :----: | ----: |
| a    |   b    |     c |

Gauche	Centre	Droite
a	b	c

La ligne de séparation définit l'alignement avec des deux-points. Les cellules peuvent contenir de la mise en forme inline, des liens et du code ; utilisez \| pour une barre verticale littérale. Les barres extérieures sont optionnelles.

Blocs de code

```javascript
const answer = 42;
```

Trois accents graves (ou tildes) ouvrent et ferment un bloc délimité ; le mot après la délimitation d'ouverture définit le langage pour la coloration syntaxique — js, python, bash, json, yaml, diff, sql et plus de 50 autres. Indenter un bloc de quatre espaces crée aussi un bloc de code, mais les délimitations sont plus claires et permettent d'indiquer un langage. Pour afficher des accents graves dans un bloc, utilisez une délimitation plus longue (quatre accents graves).

Extras GitHub-Flavored

Markdown	Rendu	Notes
`> [!NOTE]`	encadré ⓘ Note	Aussi `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
`texte[^1] … [^1]: La note.`	texte¹ avec la note à la fin	Notes de bas de page
`:rocket: :sparkles:`	🚀 ✨	Codes emoji
`<details><summary>Plus</summary>…</details>`	une section repliable	HTML inline ; laissez une ligne vide avant le Markdown intérieur
`<kbd>Ctrl</kbd>+<kbd>C</kbd>`	`Ctrl`+`C`	Touches du clavier
`[[toc]]`	une table des matières	Générée à partir des titres (cette visionneuse)
`--- title: Doc ---`	front matter	Métadonnées YAML tout en haut du fichier

Formules et diagrammes

Markdown	Rendu	Notes
$E = mc^2$	formule inline	Syntaxe KaTeX / LaTeX
`$$ \int_0^1 x^2\,dx $$`	une formule centrée en mode affichage	Sur ses propres lignes
```mermaid flowchart LR A --> B ```	un organigramme	Mermaid : flowchart, sequence, class, state, gantt, pie…

Les formules et Mermaid ne font pas partie du standard Markdown, mais cette visionneuse, GitHub (Mermaid et formules), Obsidian, Typora et la plupart des outils de documentation les prennent en charge. Tous les types de diagrammes Mermaid que cette visionneuse dessine sont listés sur la page éditeur Mermaid en ligne.

En action

Alertes Note, Important, Warning et Caution façon GitHub, une citation et une section details repliable dans le thème GitHub Dark — Alertes façon GitHub, citations et sections <details> repliables, en GitHub Dark.

Formule KaTeX en mode affichage et organigramme Mermaid rendus dans l'aperçu — Les formules KaTeX et les organigrammes Mermaid sont rendus directement dans le document.

Blocs de code TypeScript, Python, Bash et diff avec coloration syntaxique, étiquettes de langage et boutons de copie — Les blocs de code ont une étiquette de langage, une coloration syntaxique pour plus de 50 langages et un bouton de copie — ici le thème One Dark.

Questions fréquentes

Qu'est-ce que le Markdown ?

Un langage de balisage léger créé par John Gruber en 2004. Des symboles en texte brut comme # et ** décrivent la mise en forme, et un moteur transforme le texte en HTML. Il sert pour les README, la documentation, les notes, les messages de discussion et les réponses des assistants IA.

Qu'est-ce que le GitHub-Flavored Markdown (GFM) ?

L'extension par GitHub de la spécification CommonMark, ajoutant tableaux, listes de tâches, barré, liens automatiques et alertes. C'est le standard de fait pour la documentation des développeurs et ce que cette visionneuse rend.

Comment faire un saut de ligne sans nouveau paragraphe ?

Terminez la ligne par une barre oblique inverse ou par deux espaces. Une ligne vide commence au contraire un nouveau paragraphe.

Comment échapper les caractères spéciaux ?

Placez une barre oblique inverse devant : \* \_ \# \` \| \[ \]. Dans les portions de code et les blocs de code, rien n'a besoin d'être échappé.

Comment ajouter une table des matières ?

Écrivez [[toc]] sur sa propre ligne dans cette visionneuse, ou liez manuellement les titres avec [Section](#nom-de-section).

Puis-je tester ces exemples ?

Oui — ouvrez l'éditeur, collez n'importe quel exemple et regardez l'aperçu en direct. Le document d'exemple illustre aussi toutes les syntaxes de cette page.

Outils associés

Prêt quand vous l'êtes

Collez du Markdown, déposez un fichier ou ouvrez une URL — l'aperçu apparaît instantanément et tout reste sur votre appareil.

Ouvrir Markdown Viewer