Markdown Cheat Sheet : toute la syntaxe avec des exemples (2026)

Ajoutez cette page à vos favoris. Ou récupérez la version gratuite en PDF de l'aide-mémoire Markdown pour l'avoir à portée de main hors ligne.

La syntaxe Markdown en un coup d'œil

Qu'est-ce que le Markdown ?

Le Markdown est une syntaxe de formatage en texte brut créée par John Gruber et Aaron Swartz en 2004. Elle utilise des symboles simples pour baliser le texte afin qu'il puisse être converti en HTML et dans d'autres formats. L'objectif était la lisibilité. Un fichier Markdown doit rester net en texte brut et ne devenir plus joli qu'une fois affiché.

Aujourd'hui, le Markdown est partout. Les README de GitHub, les publications Reddit, les messages Discord, les pages Notion, les notes Obsidian, les réponses des chatbots d'IA et la plupart des sites de documentation l'utilisent. Si vous écrivez quoi que ce soit sur un ordinateur en 2026, vous produisez presque certainement du Markdown, que vous le sachiez ou non.

Pour en savoir plus sur le format lui-même, lisez qu'est-ce qu'un fichier .md, comment ouvrir et lire un fichier .md, ou Markdown vs HTML pour comprendre en quoi les deux formats diffèrent. Pour une référence complète, élément par élément, consultez la documentation Markdown.

Titres

Utilisez des symboles # au début d'une ligne pour créer des titres. Le nombre de dièses définit le niveau du titre, de H1 (le plus grand) à H6 (le plus petit).

# Titre 1
## Titre 2
### Titre 3
#### Titre 4
##### Titre 5
###### Titre 6

Syntaxe de titre alternative (Setext)

Pour H1 et H2 uniquement, vous pouvez utiliser des titres soulignés :

Titre 1
=========

Titre 2
---------

La plupart des rédacteurs s'en tiennent à la syntaxe # parce qu'elle fonctionne à tous les niveaux et qu'elle est plus facile à parcourir des yeux.

Conseils :

• Mettez toujours un espace entre le # et le texte du titre
• N'utilisez qu'un seul H1 par document (c'est le titre)
• Laissez une ligne vide avant et après les titres pour un rendu le plus sûr possible

Guide complet : Les titres en Markdown →

Paragraphes et sauts de ligne

Les paragraphes sont séparés par une ligne vide. Il suffit d'appuyer deux fois sur Entrée.

Ceci est le premier paragraphe.

Ceci est le deuxième paragraphe.

Sauts de ligne au sein d'un paragraphe

Pour couper une ligne sans commencer un nouveau paragraphe, terminez la ligne par deux espaces suivis d'Entrée, ou utilisez une barre oblique inverse \ :

Première ligne.
Deuxième ligne sur une nouvelle ligne, même paragraphe.

Première ligne.\
Deuxième ligne avec une barre oblique inverse.

Les deux produisent une balise <br> en HTML. La méthode des espaces en fin de ligne est plus traditionnelle mais invisible dans votre éditeur, ce qui prête à confusion. La méthode de la barre oblique inverse est plus claire et prise en charge par GitHub Flavored Markdown.

Guide complet : Paragraphes → · Sauts de ligne →

Gras, italique et autres mises en forme du texte

Voici les bases de la mise en forme que vous utiliserez sans arrêt.

**texte en gras** ou __texte en gras__
*texte en italique* ou _texte en italique_
***gras et italique*** ou ___gras et italique___
~~texte barré~~

Le gras et l'italique font partie du cœur de CommonMark et fonctionnent partout. Le barré est une extension GFM détaillée plus bas.

Quand utiliser les astérisques plutôt que les tirets bas

** et __ produisent tous deux du gras. * et _ produisent tous deux de l'italique. Ils sont interchangeables, alors choisissez-en un et tenez-vous-y par souci de cohérence.

La différence pratique apparaît à l'intérieur d'un mot. CommonMark et GFM ignorent les tirets bas entre des lettres, donc les tirets bas restent littéraux, tandis que les astérisques déclenchent toujours l'emphase :

Reste littéral :  ce_mot_contient_des_tirets_bas
Devient italique : ce*mot*contient*des*astérisques

Utilisez les tirets bas dans du texte qui contient des tirets bas (comme file_name) pour éviter des italiques accidentels, et utilisez les astérisques quand vous voulez réellement une emphase à l'intérieur d'un mot :

in**croy**able

Guide complet : Emphase : gras et italique →

Listes

Les listes se déclinent en deux variétés : non ordonnées (à puces) et ordonnées (numérotées).

Listes à puces

Utilisez -, * ou + suivi d'un espace. Les trois fonctionnent de façon identique. La plupart des guides de style préfèrent -.

- Premier élément
- Deuxième élément
- Troisième élément
  - Élément imbriqué (indentation de 2 ou 4 espaces)
  - Un autre élément imbriqué
    - Élément profondément imbriqué
- Quatrième élément

Listes ordonnées

Utilisez des nombres suivis d'un point. Les nombres eux-mêmes n'ont pas d'importance, le Markdown renumérote automatiquement :

1. Premier élément
2. Deuxième élément
3. Troisième élément
   1. Élément imbriqué
   2. Un autre élément imbriqué
4. Quatrième élément

Vous pouvez aussi écrire ceci et obtenir le même résultat :

1. Premier élément
1. Deuxième élément
1. Troisième élément

C'est une fonctionnalité, pas un bug. Cela signifie que vous pouvez réordonner les éléments d'une liste sans renuméroter à la main.

Listes mixtes

Vous pouvez imbriquer des listes à puces dans des listes ordonnées et inversement :

1. Étape un
2. Étape deux
   - Sous-point A
   - Sous-point B
3. Étape trois

Guide complet : Les listes en Markdown →

Liens

Les liens utilisent des crochets pour le texte visible et des parenthèses pour l'URL.

Liens en ligne de base

[Markdific](https://markdific.com)
[Visitez notre blog](https://markdific.com/blog "Titre au survol optionnel")

Liens automatiques

Entourez une URL de chevrons pour créer un lien automatique :

<https://markdific.com>
<[email protected]>

Liens par référence

Utiles lorsque le même lien apparaît plusieurs fois ou lorsque vous voulez garder le texte propre :

Lisez notre [aide-mémoire][1] ou le [blog][2].

Plus loin dans le document ou tout en bas :

[1]: https://markdific.com/resources/markdown-cheat-sheet
[2]: https://markdific.com/blog/

Vous pouvez aussi utiliser des références nommées :

Découvrez [Markdific][md-home].

[md-home]: https://markdific.com

Lier vers des sections (liens d'ancre)

GitHub et la plupart des moteurs de rendu génèrent automatiquement des identifiants d'ancre à partir du texte des titres (en minuscules, les espaces remplacés par des traits d'union) :

[Aller aux tableaux](#tables)
[Aller aux alertes GitHub](#github-alerts)

Guide complet : Liens → · Liens automatiques → · Identifiants de titre →

Wikilinks et intégrations (embeds)

Obsidian, et quelques autres outils de prise de notes, ajoutent les wikilinks à double crochet et les intégrations (embeds) par-dessus le Markdown standard :

[[Titre de la note]]            lien vers une autre note
[[Titre de la note|Alias]]      lien avec un texte personnalisé
![[Titre de la note]]           intègre le contenu d'une autre note
![[image.png]]                  intègre une image

Il s'agit d'une extension d'Obsidian, pas de Markdown standard, donc ces éléments ne se résolvent pas sur GitHub ni sur la plupart des sites statiques. Consultez Markdown dans Obsidian pour l'ensemble complet.

Images

La syntaxe des images est presque identique à celle des liens, avec un point d'exclamation devant.

![Texte alternatif décrivant l'image](chemin/vers/image.jpg)
![Texte alternatif](chemin/vers/image.jpg "Titre au survol optionnel")

Dimensionnement des images

Le Markdown pur ne prend pas en charge le dimensionnement des images. Vous avez deux options :

Option 1 : utiliser directement du HTML

<img src="chemin/vers/image.jpg" alt="Description" width="500">

Option 2 : utiliser des extensions propres à la plateforme

Obsidian, par exemple, prend en charge :

![[image.jpg|500]]

Images par référence

![Logo Markdific][logo]

[logo]: /images/logo.png "Markdific"

Lier une image

Pour rendre une image cliquable, entourez la syntaxe de l'image d'un lien :

[![Texte alternatif](image.jpg)](https://destination-url.com)

Pour les cas que le Markdown pur ne couvre pas (fichiers locaux, dimensionnement précis ou images intégrées en Base64), utilisez la balise HTML brute <img> présentée plus haut.

Guide complet : Les images en Markdown →

Code et blocs de code

La mise en forme du code est l'une des fonctionnalités les plus utiles du Markdown.

Code en ligne

Entourez le code d'accents graves simples :

Utilisez la fonction `print()` en Python.

Si votre code contient un accent grave, entourez-le d'accents graves doubles :

Le caractère `` ` `` s'appelle un accent grave.

Blocs de code (délimités)

Utilisez trois accents graves pour les blocs de code multilignes. Ajoutez un identifiant de langage après les accents graves d'ouverture pour la coloration syntaxique :

```python
def hello_world():
    print("Hello, world!")
```

```javascript
function helloWorld() {
  console.log("Hello, world!");
}
```

```bash
npm install markdown-it
```

Identifiants de langage courants

• python, py
• javascript, js
• typescript, ts
• bash, sh, shell
• html, xml
• css, scss
• json, yaml
• sql, graphql
• markdown, md
• diff (pour les diffs git)
• plaintext, text (aucune coloration)

Blocs de code indentés (ancienne méthode)

Indentez n'importe quelle ligne de quatre espaces ou d'une tabulation pour en faire un bloc de code. Cela fonctionne mais c'est moins lisible que les blocs délimités. À éviter.

Guide complet : Code → · Blocs de code délimités → · Coloration syntaxique →

Citations

Utilisez > au début d'une ligne pour créer une citation.

> Ceci est une citation.
> Elle peut s'étendre sur plusieurs lignes.

> Vous pouvez aussi avoir une citation sur une seule ligne.

Citations imbriquées

Empilez les caractères > :

> Citation externe.
>
> > Citation imbriquée.
> >
> > > Citation profondément imbriquée.

Citations avec d'autres éléments Markdown

Les citations peuvent contenir des titres, des listes, du code et d'autres mises en forme :

> ### Un titre à l'intérieur d'une citation
>
> - Un élément de liste
> - Un autre élément
>
> Un peu de `code en ligne` et de **texte en gras**.

Guide complet : Citations →

Lignes horizontales

Trois traits d'union, astérisques ou tirets bas ou plus, seuls sur leur ligne :

---
***
___

Les trois produisent un <hr>. Utilisez-les avec parcimonie. La plupart des documents modernes s'appuient plutôt sur une hiérarchie de titres.

Guide complet : Lignes horizontales →

Tableaux

Les tableaux sont une extension de GitHub Flavored Markdown, pas du CommonMark standard, mais ils sont désormais pris en charge presque partout.

Tableau de base

| En-tête 1 | En-tête 2 | En-tête 3 |
|----------|----------|----------|
| Cellule 1 | Cellule 2 | Cellule 3 |
| Cellule 4 | Cellule 5 | Cellule 6 |

Alignement des colonnes

Ajoutez des deux-points à la ligne de séparation :

| Aligné à gauche | Centré | Aligné à droite |
|:-------------|:--------------:|--------------:|
| Texte         | Texte           | Texte          |
| Texte plus long  | Texte plus long    | Texte plus long   |

• :--- alignement à gauche (par défaut)
• :---: alignement centré
• ---: alignement à droite

Conseils pour des tableaux plus propres

• Les barres verticales extérieures sont facultatives mais améliorent la lisibilité
• La largeur des colonnes dans la source n'affecte pas le rendu (les moteurs de rendu ignorent les espaces superflus)
• Les barres verticales à l'intérieur des cellules doivent être échappées avec \|
• Les tableaux GFM standard ne peuvent pas avoir de cellules multilignes ni de cellules fusionnées ; utilisez du HTML pour cela

Pour un guide complet, y compris la manière de gérer les tableaux complexes, ainsi que notre générateur de tableaux Markdown gratuit, lisez notre guide complet des tableaux Markdown.

Guide complet : Les tableaux en Markdown →

Listes de tâches

Les listes de tâches (aussi appelées listes de choses à faire) sont une extension GFM prise en charge par GitHub, GitLab et la plupart des éditeurs modernes.

- [x] Tâche terminée
- [ ] Tâche en cours
- [ ] Une autre tâche en cours
  - [x] Sous-tâche imbriquée terminée
  - [ ] Sous-tâche imbriquée en cours

Le [x] est sensible à la casse dans certains moteurs de rendu. Utilisez un x minuscule pour plus de sûreté.

Guide complet : Listes de tâches →

Notes de bas de page

Les notes de bas de page sont une extension de GitHub, et sont aussi prises en charge par MultiMarkdown et Pandoc. Elles sont parfaites pour les citations et les apartés.

Ceci est une phrase avec une note de bas de page.[^1]

Vous pouvez avoir plusieurs notes de bas de page.[^note]

[^1]: Voici le contenu de la première note de bas de page.
[^note]: Voici une note de bas de page nommée avec un contenu plus long
    qui peut s'étendre sur plusieurs lignes si elles sont indentées.

Les notes de bas de page se numérotent automatiquement et apparaissent au bas du document affiché avec des liens de retour.

Guide complet : Notes de bas de page →

Listes de définitions

Les listes de définitions sont prises en charge par Pandoc, MultiMarkdown et quelques autres variantes (flavors), mais pas par le cœur de GFM.

Terme
: Définition du terme.

Markdown
: Un langage de balisage léger pour créer du texte formaté.
: Créé par John Gruber en 2004.

Vérifiez votre moteur de rendu cible avant de compter sur ces éléments. Ils sont irréguliers d'une plateforme à l'autre.

Guide complet : Listes de définitions →

Abréviations

MultiMarkdown et PHP Markdown Extra vous permettent de définir une abréviation une fois et de la faire se développer partout où le terme apparaît :

La spécification HTML est maintenue par le W3C.

*[HTML]: HyperText Markup Language
*[W3C]: World Wide Web Consortium

Cela ne fait pas partie de CommonMark ni de GFM, donc la plupart des moteurs de rendu (y compris GitHub) affichent les lignes de définition comme du texte littéral. Ne l'utilisez que là où vous savez que la cible le prend en charge.

Barré

Entourez le texte de doubles tildes :

~~Ce texte est barré~~

Rendu : Ce texte est barré

Extension GFM. Prise en charge universellement dans les moteurs de rendu modernes.

Guide complet : Barré →

Indice, exposant et surlignage

Ces trois marques en ligne sont des fonctionnalités étendues. Aucune ne fait partie du cœur de CommonMark ni de GitHub Flavored Markdown, donc la prise en charge varie, mais chacune dispose d'une solution de repli HTML fiable qui fonctionne partout.

Indice et exposant

Pandoc, MultiMarkdown et une poignée d'autres variantes (flavors) prennent en charge la syntaxe avec tilde et accent circonflexe :

L'eau, c'est H~2~O.
La surface est de 10 m^2^.

Là où cette syntaxe n'est pas prise en charge (GitHub et la plupart des moteurs de rendu CommonMark), utilisez plutôt les balises HTML, elles s'affichent partout :

L'eau, c'est H<sub>2</sub>O.
La surface est de 10 m<sup>2</sup>.

Surlignage

Obsidian et quelques autres outils surlignent le texte entouré de doubles signes égal :

Le Markdown fait ==ressortir cette partie==.

Pour les moteurs de rendu qui ne prennent pas en charge ==, utilisez la balise HTML <mark> : <mark>surligné</mark>.

Guide complet : Indice et exposant → · Surlignage →

Emoji

Trois façons d'utiliser les emojis en Markdown :

1. Coller directement

Il suffit de taper ou de coller le caractère emoji réel : 🎉 ✅ 🚀

Cela fonctionne partout parce que les emojis ne sont que des caractères Unicode.

2. Codes courts (GFM)

GitHub et GitLab prennent en charge une syntaxe de codes courts qui convertit des codes textuels en emojis :

:tada: :white_check_mark: :rocket:

Ceux-ci s'affichent sous la forme 🎉 ✅ 🚀 sur les plateformes prises en charge. Discord et Slack utilisent une syntaxe :code: similaire mais avec leurs propres bibliothèques d'emojis, donc les codes disponibles diffèrent. Consultez Markdown dans Discord et Markdown dans Slack pour savoir comment chaque application de messagerie gère la mise en forme.

3. Entités HTML

Pour une compatibilité maximale, vous pouvez aussi utiliser des codes d'entités HTML, même si les codes courts sont bien plus lisibles.

Guide complet : Les emojis en Markdown →

HTML dans le Markdown

Vous pouvez intégrer du HTML brut dans du Markdown pour les cas que la syntaxe ne couvre pas :

<details>
<summary>Cliquez pour développer</summary>

Ce contenu est masqué par défaut et affiché quand l'utilisateur clique.

</details>

Usages courants du HTML brut :

• <details> et <summary> pour les sections repliables
• <sub> et <sup> pour l'indice et l'exposant
• <kbd> pour les touches du clavier (rendu avec un style de type Ctrl + C)
• <mark> pour le surlignage
• <img> avec des attributs de largeur pour les images dimensionnées
• Tableaux avec cellules fusionnées, cellules multilignes ou mises en page complexes

Exemple de touches du clavier

Appuyez sur <kbd>Ctrl</kbd> + <kbd>C</kbd> pour copier.

Mises en garde

Certaines plateformes suppriment ou nettoient le HTML pour des raisons de sécurité (Reddit, par exemple). GitHub autorise la plupart du HTML mais bloque <script> et quelques autres balises. Testez toujours sur votre plateforme cible.

Guide complet : HTML en ligne dans le Markdown →

Commentaires

Le Markdown n'a pas de syntaxe de commentaire officielle, mais il existe deux façons fiables de laisser des notes dans un fichier sans qu'elles apparaissent jamais dans le rendu.

Commentaires HTML

Tout moteur de rendu qui autorise le HTML honore aussi les commentaires HTML :

<!-- Cette note est invisible dans la page affichée. -->

Le contenu visible continue ici.

Le commentaire est ignoré lorsque le fichier est affiché. Il existe cependant toujours dans le code source HTML, alors considérez-le comme masqué aux lecteurs plutôt que réellement privé.

L'astuce du lien par référence

Pour les moteurs de rendu qui suppriment le HTML (certaines applications de messagerie et visionneuses en bac à sable), utilisez une définition de lien par référence vide. Elle ne produit aucune sortie parce que rien ne pointe jamais vers elle :

[//]: # (Ceci est un commentaire qui n'affiche rien.)

[comment]: # (Une autre façon d'écrire la même chose.)

Cela fonctionne dans presque tous les analyseurs, car une définition de lien qui n'est jamais référencée est tout simplement ignorée. C'est la manière la plus portable de masquer une note.

Caractères d'échappement

Pour afficher un caractère Markdown littéralement, faites-le précéder d'une barre oblique inverse :

\* Ceci n'est pas de l'italique \*
\# Ceci n'est pas un titre
\[Ceci n'est pas un lien\](not-a-url)

Caractères que vous pouvez échapper :

\ `` * _ {} [] () # + - . ! |`

Guide complet : Échappement des caractères →

Équations mathématiques (LaTeX)

Les maths sont prises en charge par GitHub, GitLab, Obsidian, Notion et la plupart des outils de documentation modernes en tant que fonctionnalité du moteur de rendu. Utilisez la syntaxe LaTeX à l'intérieur de signes dollar.

Maths en ligne

Des signes dollar simples pour les maths en ligne :

Le théorème de Pythagore, c'est $a^2 + b^2 = c^2$.

GitHub prend aussi en charge un délimiteur en ligne alternatif qui entoure les maths d'un signe dollar et d'un accent grave de chaque côté, pour les cas où vos maths contiennent des caractères qui entrent en conflit avec le Markdown :

Ici, $`a + b = c`$ utilise les délimiteurs alternatifs.

Maths en bloc

Des signes dollar doubles pour les équations au niveau bloc :

$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

Motifs LaTeX courants

Fractions :        $\frac{a}{b}$
Racine carrée :      $\sqrt{x}$
Puissances :           $x^{2}$
Indices :       $x_{i}$
Lettres grecques :    $\alpha, \beta, \gamma, \pi, \theta$
Somme :              $\sum_{i=1}^{n} i$
Intégrale :         $\int_{0}^{1} x \, dx$
Matrice :           $\begin{pmatrix} a & b \\ c & d \end{pmatrix}$

Les moteurs de rendu varient sur la syntaxe. GitHub utilise MathJax. Certaines plateformes exigent KaTeX, qui suit des conventions légèrement différentes.

Guide complet : Maths LaTeX →

Diagrammes Mermaid

Mermaid est une bibliothèque JavaScript qui transforme du texte en diagrammes. GitHub, GitLab, Notion, Obsidian et la plupart des moteurs de rendu Markdown modernes le prennent en charge nativement. C'est l'une des fonctionnalités les plus utiles du Markdown moderne.

Organigramme

```mermaid
flowchart TD
    A[Départ] --> B{Est-ce que ça marche ?}
    B -->|Oui| C[On expédie]
    B -->|Non| D[Débogage]
    D --> B
```

Diagramme de séquence

```mermaid
sequenceDiagram
    Utilisateur->>Navigateur: Ouvrir un fichier .md
    Navigateur->>Markdific: Afficher le markdown
    Markdific-->>Navigateur: Renvoyer le HTML
    Navigateur-->>Utilisateur: Afficher la page formatée
```

Autres types de diagrammes Mermaid

• flowchart (flux de processus)
• sequenceDiagram (interactions dans le temps)
• classDiagram (classes UML)
• stateDiagram-v2 (machines à états)
• erDiagram (schémas de base de données)
• gantt (calendriers de projet)
• pie (diagrammes circulaires)
• mindmap (cartes mentales)
• journey (parcours utilisateur)
• gitGraph (visualisations de branches git)

Mermaid prend en charge bien plus de types de diagrammes que ceux présentés ici. Ceux qui s'affichent dépendent de la version de Mermaid de votre outil. GitHub et GitLab maintiennent la leur à jour, donc la plupart des types de diagrammes fonctionnent d'emblée.

Guide complet : Diagrammes Mermaid →

Alertes GitHub

Les alertes GitHub (aussi appelées « callouts » ou « admonitions ») sont une fonctionnalité de GitHub déployée fin 2023. Elles affichent des citations spéciales avec des icônes et des couleurs, et sont désormais largement prises en charge par d'autres moteurs de rendu Markdown.

> [!NOTE]
> Information utile que les utilisateurs devraient connaître.

> [!TIP]
> Conseil utile pour faire les choses mieux.

> [!IMPORTANT]
> Information clé que les utilisateurs ont besoin de connaître.

> [!WARNING]
> Information urgente nécessitant une attention immédiate.

> [!CAUTION]
> Avertit sur des risques ou des conséquences négatives.

Les cinq types pris en charge sont NOTE, TIP, IMPORTANT, WARNING et CAUTION. D'autres outils Markdown (Obsidian, MkDocs, Docusaurus) utilisent une syntaxe similaire mais légèrement différente pour les callouts. Consultez Markdown sur GitHub pour savoir comment s'affichent les alertes et les autres fonctionnalités de GitHub.

YAML Frontmatter

Le frontmatter est un bloc de métadonnées YAML placé en haut d'un fichier Markdown, utilisé par les générateurs de sites statiques (Hugo, Jekyll, Astro, Next.js), les plateformes CMS et les applications de prise de notes.

---
title: "Le titre de mon article"
date: 2026-01-15
author: Jane Doe
tags:
  - markdown
  - tutoriel
  - référence
draft: false
description: Un court résumé pour le SEO.
---

# Le contenu de l'article commence ici

Trois traits d'union ouvrent et ferment le bloc. À l'intérieur, utilisez la syntaxe YAML standard. Champs courants :

• title
• date
• author ou authors
• tags ou categories
• description (pour les balises méta)
• draft (booléen)
• slug ou permalink
• image (chemin de l'image à la une)

Le frontmatter est invisible dans le rendu. Ce ne sont que des métadonnées destinées au système qui traite le fichier.

Si votre frontmatter apparaît sous forme de texte littéral dans le rendu, l'analyseur ne le prend probablement pas en charge : vérifiez que le fichier commence à la ligne 1 par --- et qu'il n'y a aucune ligne vide au-dessus.

Guide complet : Front matter →

Comparaison des variantes (flavors) de Markdown

Le Markdown se décline en plusieurs « variantes » (flavors) aux fonctionnalités différentes. Savoir laquelle utilise votre plateforme cible évite les problèmes de rendu.

En cas de doute, écrivez en GFM. C'est ce qui se rapproche le plus d'un standard universel du Markdown en 2026. Pour le comportement propre à chaque plateforme, consultez Markdown dans Obsidian et Markdown dans Notion.

Guide complet : Comparaison des variantes (flavors) de Markdown →

Erreurs courantes

Elles piègent constamment les rédacteurs. Évitez-les.

1. Oublier les lignes vides

Le Markdown a souvent besoin d'une ligne vide entre les éléments :

Ceci est un paragraphe.
- Cette liste pourrait ne pas s'afficher
- selon le moteur de rendu.

Corrigez avec une ligne vide :

Ceci est un paragraphe.

- Cette liste s'affiche correctement.
- Tous les moteurs de rendu sont d'accord.

2. Mélanger les indentations

Lorsque vous imbriquez des listes ou ajoutez des paragraphes à des éléments de liste, utilisez une indentation cohérente (2 ou 4 espaces). Mélanger tabulations et espaces casse le rendu.

3. Espaces en fin de ligne pour les sauts de ligne

L'astuce des « deux espaces en fin de ligne » pour les sauts de ligne légers est invisible et se casse facilement. Utilisez plutôt une barre oblique inverse, ou acceptez simplement que ce sont généralement des paragraphes que vous voulez.

4. Ne pas échapper les caractères spéciaux

Écrire func_name_with_underscores dans du texte est sûr en CommonMark et GFM, qui ignorent les tirets bas entre des lettres, même si certains analyseurs plus anciens les lisent encore comme de l'emphase. Les astérisques sont plus risqués ici, puisque a*b*c met en italique. Pour être en sécurité partout, entourez les termes techniques d'accents graves pour en faire du code en ligne. Autres collisions courantes : < et > lus comme des balises HTML, et | à l'intérieur des cellules de tableau qui casse la mise en page du tableau.

5. Se reposer sur des fonctionnalités non standard

Si vous utilisez les wikilinks d'Obsidian [[note]] puis publiez sur un site statique qui ne les prend pas en charge, vos liens se cassent. Connaissez votre moteur de rendu cible.

6. Des tableaux trop larges

Les tableaux GFM ne peuvent pas défiler horizontalement. Si un tableau est trop large pour la page, il déborde. Divisez les tableaux larges en plusieurs tableaux plus étroits ou utilisez du HTML.

7. Titres vides ou titres contenant uniquement de la mise en forme

## **Titre en gras**

Cela fonctionne, mais certains moteurs de rendu suppriment la mise en forme des titres ou génèrent des identifiants d'ancre étranges. Gardez des titres simples.

Téléchargez l'aide-mémoire en PDF

Vous voulez cet aide-mémoire hors ligne ? Téléchargez la version PDF imprimable pour la garder sur votre bureau ou la partager avec votre équipe.

Foire aux questions

Qu'est-ce qu'un aide-mémoire Markdown ?

Un aide-mémoire Markdown est une référence rapide qui répertorie chaque élément de syntaxe Markdown accompagné d'un exemple montrant comment l'écrire, titres, texte en gras et en italique, listes, liens, images, blocs de code, tableaux, et bien plus. Cette page couvre tout CommonMark ainsi que les extensions de GitHub Flavored Markdown.

Comment mettre du texte en gras en Markdown ?

Entourez le texte de deux astérisques : **texte en gras**. Deux tirets bas (__texte en gras__) fonctionnent aussi. Pour l'italique, utilisez un seul astérisque ou tiret bas ; pour le gras et l'italique combinés, utilisez-en trois : ***texte***.

Comment créer un tableau en Markdown ?

Séparez les colonnes par des barres verticales et ajoutez une ligne de tirets sous la ligne d'en-tête pour marquer le tout comme un tableau :

| Nom | Rôle |
|------|------|
| Ada  | Chef |

Ou faites l'impasse sur la syntaxe et construisez-en un visuellement avec notre générateur de tableaux Markdown gratuit.

Quelle est la différence entre Markdown et GitHub Flavored Markdown ?

CommonMark est la syntaxe de base standardisée. GitHub Flavored Markdown (GFM) l'étend avec des tableaux, des listes de tâches, le barré, les liens automatiques, les notes de bas de page et les alertes. GFM est la variante la plus largement prise en charge, c'est donc le choix par défaut le plus sûr en 2026.

Le Markdown est-il la même chose que le HTML ?

Non. Le Markdown est une syntaxe légère en texte brut qui se convertit en HTML. Le Markdown sert à écrire et à éditer ; le HTML sert à l'affichage. Notre guide Markdown vs HTML explique quand utiliser chacun.

Comment ajouter un lien en Markdown ?

Placez le texte visible entre crochets, suivi de l'URL entre parenthèses : [Markdific](https://markdific.com). Pour transformer une image en lien, entourez la syntaxe de l'image des mêmes crochets.

Comment ajouter un commentaire en Markdown ?

Le Markdown n'a pas de syntaxe de commentaire officielle. La méthode la plus portable est un lien par référence vide, [//]: # (votre note), qui n'affiche rien. Dans tout moteur de rendu qui autorise le HTML, un commentaire HTML <!-- votre note --> fonctionne aussi.

Comment créer une liste de contrôle en Markdown ?

Utilisez une liste de tâches : commencez chaque élément par - [ ] pour une tâche en cours ou - [x] pour une tâche terminée. Les listes de tâches sont une fonctionnalité de GitHub Flavored Markdown prise en charge par GitHub, GitLab et la plupart des éditeurs modernes.

Comment ajouter une image en Markdown ?

Utilisez un point d'exclamation, le texte alternatif entre crochets et le chemin entre parenthèses : ![Texte alternatif](chemin/vers/image.jpg). Pour dimensionner une image, utilisez plutôt une balise HTML <img> avec un attribut width.

Comment écrire un bloc de code en Markdown ?

Entourez le code de trois accents graves, chacun sur sa propre ligne. Ajoutez un nom de langage après les accents graves d'ouverture pour la coloration syntaxique. Pour un court extrait à l'intérieur d'une phrase, utilisez des accents graves simples autour du code.

Comment faire une table des matières en Markdown ?

Le Markdown n'a pas de table des matières intégrée, mais vous pouvez en construire une à partir de liens d'ancre comme [Titre de section](#titre-de-section), en utilisant le titre en minuscules avec les espaces remplacés par des traits d'union. GitHub, GitLab et de nombreux éditeurs en génèrent aussi une automatiquement.

Comment convertir du Markdown en Word ou en PDF ?

Utilisez un convertisseur. Markdific propose des outils en ligne gratuits pour convertir du Markdown en Word, PDF, HTML, et plus encore, le tout s'exécutant dans votre navigateur sans inscription.

Guides et outils associés

Le Markdown par plateforme. Découvrez exactement comment le Markdown se comporte dans les outils que vous utilisez au quotidien :

• Markdown sur GitHub
• Markdown dans Obsidian
• Markdown dans Notion
• Markdown dans VS Code
• Markdown dans Discord
• Markdown dans Slack
• Markdown dans Jupyter
• Markdown dans Confluence
• Comment écrire un README
• Fichiers Markdown pour les agents d'IA

Convertissez votre Markdown. Des convertisseurs en ligne gratuits qui s'exécutent dans votre navigateur, sans inscription :

• Markdown vers Word
• Markdown vers PDF
• Markdown vers HTML
• Markdown vers Texte
• Markdown vers Image
• Markdown vers Google Docs

Points clés

Voilà toute la syntaxe Markdown que vous rencontrerez réellement en 2026. Les points clés à retenir :

• CommonMark + GFM couvre 95 % de l'usage réel du Markdown
• Tableaux, listes de tâches, notes de bas de page, maths, mermaid et alertes sont les extensions à mémoriser
• Les solutions de repli HTML gèrent les cas limites que le Markdown ne couvre pas
• Le frontmatter est essentiel pour tout site statique ou système de contenu
• Les diagrammes Mermaid sont l'une des fonctionnalités les plus sous-utilisées du Markdown

Le format continuera d'évoluer à mesure que les contenus générés par IA inondent le web de fichiers .md, mais la syntaxe de base est stable depuis 2004 et ne changera pas. Apprenez-la une fois et elle vous sera utile pendant des décennies.

Vous voulez voir votre Markdown affiché proprement ? Markdific est une visionneuse et un éditeur Markdown rapides et dédiés, pour Mac et Windows. Pour en savoir plus, lisez Markdown vs HTML, parcourez nos ressources Markdown, ou consultez la documentation Markdown complète.

Markdific

Markdific transforme du Markdown brut en documents propres et lisibles sur n'importe quel appareil. Ouvrez n'importe quel fichier .md et voyez instantanément des titres, des tableaux, du code, des maths et des images corrects, puis modifiez avec la sauvegarde automatique, changez de thème et exportez en PDF, Word ou HTML.