Syntaxe Markdown de base : le guide
La syntaxe markdown de base regroupe les 11 éléments de mise en forme définis par John Gruber dans le document de conception original de 2004, et presque toutes les applications markdown en 2026 prennent encore en charge l'ensemble complet. Les 11 éléments sont les titres, les paragraphes, les sauts de ligne, l'emphase, les citations, les listes, le code, les lignes horizontales, les liens, les images et l'échappement de caractères. Chaque élément utilise des signes de ponctuation déjà présents sur votre clavier, et chacun se convertit en une balise HTML précise. De petites différences existent entre les processeurs, ce guide signale donc les choix qui s'affichent à l'identique partout. Chaque exemple ci-dessous se colle directement dans un éditeur markdown avec aperçu en direct, et le rendu apparaît pendant que vous tapez.
Titres
Un titre markdown commence par 1 à 6 croisillons (#) suivis d'une espace, et le nombre de croisillons détermine le niveau, de H1 à H6.
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6
Chaque ligne se convertit en balise HTML correspondante : # Page Title s'affiche comme un élément h1 et ###### Fine Print comme un h6. Markdown propose aussi une syntaxe alternative pour les 2 premiers niveaux. Placez un nombre quelconque de signes égal sur la ligne sous le texte pour un H1, ou un nombre quelconque de tirets pour un H2. La forme avec # s'appelle le style ATX ; la forme soulignée s'appelle le style Setext.
Heading level 1
===============
Heading level 2
---------------
Bonne pratique : laissez une ligne vide avant et après chaque titre, et gardez 1 espace entre les croisillons et le texte, pour que le titre s'affiche correctement dans toutes les applications.
Paragraphes
Un paragraphe est constitué d'une ou plusieurs lignes de texte consécutives avec une ligne vide au-dessus et en dessous, et il ne demande aucun marqueur.
The first paragraph ends here.
A blank line above this sentence starts a second paragraph.
Le moteur de rendu enveloppe chaque bloc dans une balise p, les 2 blocs ci-dessus deviennent donc 2 paragraphes HTML distincts. Les retours simples à l'intérieur d'un bloc fusionnent en texte continu, vous pouvez donc couper vos lignes source à 80 caractères et la sortie reste un paragraphe ininterrompu.
Bonne pratique : gardez chaque paragraphe collé à la marge gauche, car 4 espaces ou plus en début de ligne transforment un paragraphe en bloc de code.
Sauts de ligne
Un saut de ligne à l'intérieur d'un paragraphe exige 2 espaces ou plus en fin de ligne, ou la balise HTML <br>.
This line ends with 2 trailing spaces.
This line appears directly below it.
This line ends with a br tag.<br>
This line also sits inside the same paragraph.
Les 2 méthodes rendent un élément br, la seconde ligne se place donc directement sous la première sans écart de paragraphe. Un retour simple sans rien derrière fusionne les 2 lignes en une seule. CommonMark accepte aussi une barre oblique inverse finale comme saut, mais les processeurs plus anciens l'ignorent, les 2 options portables restent donc les espaces finales et la balise <br>.
Bonne pratique : choisissez la balise <br> quand un saut doit survivre au copier-coller et à la relecture de code, car les espaces finales restent invisibles dans la plupart des éditeurs.
Emphase : gras et italique
Le gras en markdown prend 2 astérisques de chaque côté, l'italique en prend 1 et le gras italique 3 ; les tirets bas servent d'alternative équivalente autour de mots entiers.
This word is **bold** and so is this __word__.
This word is *italic* and so is this _word_.
This phrase is ***bold and italic***.
Le moteur de rendu convertit les marqueurs en balises strong et em : **bold** devient <strong>bold</strong>, *italic* devient <em>italic</em>, et le triple marqueur imbrique une balise dans l'autre, ce qui donne du markdown gras et italique à la fois. L'emphase fonctionne aussi à l'intérieur d'un mot : un*believ*able met en italique uniquement les 6 lettres centrales.
Bonne pratique : préférez les astérisques aux tirets bas pour l'emphase en milieu de mot, car tous les grands processeurs traitent les astérisques intérieurs de la même façon, tandis que les tirets bas intérieurs varient.
Citations
Une citation commence par un chevron fermant (>) en début de ligne, et chaque ligne citée porte son propre marqueur.
> A single-paragraph quote needs 1 marker per line.
>
> A marked blank line continues the quote into a second paragraph.
>
>> Two markers push this paragraph 1 level deeper as a nested quote.
La sortie est un élément blockquote, et le double marqueur imbrique une seconde citation dans la première. Les citations acceptent aussi d'autres éléments markdown. Un titre, une liste ou du texte en gras s'affiche normalement à l'intérieur de la citation quand chacune de ses lignes commence par le marqueur >, ce qui convient aux e-mails cités et aux passages structurés.
Bonne pratique : entourez chaque citation de lignes vides pour que chaque processeur détecte exactement où la citation commence et s'arrête.
Listes
Une liste markdown ordonnée place un nombre suivi d'un point devant chaque élément, et une liste non ordonnée place un tiret, un astérisque ou un signe plus devant chaque élément.
1. First step
2. Second step
3. Third step
1. Indented sub-step
- Bullet item
- Bullet item
- Nested bullet
Les listes ordonnées s'affichent comme des éléments ol et comptent à partir du premier nombre saisi : une liste écrite 1, 8, 3 sort tout de même 1, 2, 3. Les listes non ordonnées s'affichent comme des éléments ul avec n'importe lequel des 3 délimiteurs. Un retrait de 4 espaces ou 1 tabulation imbrique une sous-liste, et le même retrait garde d'autres éléments à l'intérieur d'un élément de liste : un paragraphe ou une citation demande 4 espaces, tandis qu'un bloc de code dans une liste demande 8 espaces, car le retrait de code standard de 4 espaces s'ajoute au retrait de liste.
Bonne pratique : gardez 1 seul style de délimiteur par liste et terminez les nombres ordonnés par des points plutôt que par des parenthèses, car la forme avec point fonctionne dans toutes les applications markdown.
Code
Le code en ligne se place entre backticks simples, et un bloc de code est toute suite de lignes indentée d'au moins 4 espaces ou 1 tabulation.
Type `git status` to check the working tree.
<html>
<head></head>
</html>
La paire de backticks rend un élément code en police à chasse fixe, et le bloc indenté s'affiche dans des balises pre et code avec chaque espace préservée. Un extrait qui contient lui-même un backtick demande des backticks doubles autour de lui, ainsi the outer pair displays `code` literally. Les blocs de code clôturés par triples backticks relèvent de la syntaxe étendue ; le retrait de 4 espaces est la méthode d'origine.
Bonne pratique : entourez les backticks littéraux de backticks doubles pour que le caractère intérieur s'imprime au lieu de fermer la portée de code trop tôt.
Lignes horizontales
Une ligne horizontale exige 3 astérisques, tirets ou tirets bas ou plus, seuls sur leur propre ligne.
***
---
___
Les 3 versions rendent un élément hr identique, un séparateur pleine largeur. Le caractère peut se répéter au-delà de 3 sans changer la sortie : une ligne de 20 tirets produit le même séparateur que 3. Les auteurs utilisent ces lignes pour marquer les changements de scène et les frontières de section où un titre serait trop lourd.
Bonne pratique : laissez une ligne vide au-dessus et en dessous de chaque ligne horizontale, car une ligne de tirets placée directement sous un texte transforme ce texte en titre H2.
Liens
Un lien en ligne entoure le texte du lien de crochets et le fait suivre immédiatement de l'URL entre parenthèses, plus un titre facultatif entre guillemets.
Read the [original spec](https://daringfireball.net/projects/markdown/ "Gruber's 2004 spec").
Reference style keeps prose clean: read the [original spec][1].
[1]: https://daringfireball.net/projects/markdown/
Bare addresses work in angle brackets: <https://example.com> and <mail@example.com>
Chaque forme rend un élément a, et le texte du titre apparaît en infobulle au survol. Les liens de style référence séparent l'URL de la phrase : l'étiquette [1] pointe vers une définition qui peut se trouver n'importe où dans le fichier, un paragraphe rempli de longues URL reste donc lisible dans la source. Les chevrons convertissent une URL brute ou une adresse e-mail en lien cliquable sans texte supplémentaire. Les liens acceptent aussi la mise en forme : des astérisques autour de toute la construction mettent le lien en gras, et des backticks à l'intérieur des crochets l'affichent comme du code.
Bonne pratique : encodez toute espace dans une URL en %20 pour que l'adresse complète survive dans chaque processeur.
Images
Une image utilise un point d'exclamation, puis le texte alternatif entre crochets, puis le chemin ou l'URL de l'image entre parenthèses.
[](https://example.com/report)
La première ligne rend un élément img avec le texte alternatif comme étiquette d'accessibilité et le titre entre guillemets comme texte au survol. La syntaxe correspond à celle d'un lien avec 1 caractère supplémentaire devant. La seconde ligne imbrique toute la construction d'image dans un lien : un clic sur l'image ouvre l'URL cible.
Bonne pratique : rédigez un texte alternatif qui décrit le contenu de l'image, car les lecteurs d'écran et les moteurs de recherche le lisent à la place de l'image.
Échappement de caractères
Une barre oblique inverse () placée devant un caractère de mise en forme affiche ce caractère littéralement au lieu d'activer sa fonction markdown.
\* This line shows a literal asterisk, not a bullet point.
1968\. The escaped period stops this year from starting an ordered list.
La barre oblique inverse elle-même n'apparaît jamais dans la sortie ; seul le caractère qui la suit s'imprime. Markdown accepte un échappement par barre oblique inverse pour 12 caractères : barre oblique inverse, backtick, astérisque, tiret bas, accolades, crochets, parenthèses, croisillon, signe plus, signe moins, point et point d'exclamation. Le second exemple ci-dessus résout un piège courant, car toute ligne qui s'ouvre par un nombre et un point devient un élément de liste sans l'échappement.
Bonne pratique : n'échappez que les caractères de cette liste de 12, car une barre oblique inverse devant tout autre caractère s'imprime comme une barre visible.
Questions fréquentes
Qu'est-ce que la syntaxe markdown de base ?
La syntaxe de base est l'ensemble des 11 éléments du document de conception markdown publié par John Gruber en 2004, et presque toutes les applications markdown le prennent en charge en totalité. Les 11 éléments se comportent de façon cohérente d'un processeur à l'autre, ce qui fait de l'ensemble de base le choix le plus sûr pour les documents qui circulent entre plateformes.
Combien de niveaux de titre markdown existe-t-il ?
Markdown prend en charge 6 niveaux de titre, écrits avec 1 à 6 croisillons, qui correspondent directement aux balises HTML h1 à h6. La syntaxe alternative par soulignement ne couvre que les 2 premiers niveaux : signes égal pour un H1 et tirets pour un H2.
Comment insérer un saut de ligne sans ouvrir un nouveau paragraphe ?
Terminez la ligne par 2 espaces finales ou par la balise HTML <br>. Les 2 méthodes rendent un élément br dans le paragraphe courant. Une ligne vide a un effet différent : elle ferme le paragraphe et en ouvre un nouveau.
La syntaxe de base suffit-elle, ou faut-il la syntaxe étendue ?
La syntaxe de base couvre les documents standard, tandis que la syntaxe étendue ajoute les tableaux, les blocs de code clôturés, les notes de bas de page et d'autres éléments issus de spécifications ultérieures comme GFM. Commencez par l'ensemble de base pour une compatibilité maximale, puis ajoutez les éléments étendus une fois que la plateforme cible les prend en charge.