Syntaxe Markdown : tableau récapitulatif

Markdown met en forme du texte brut avec des signes simples : # pour un titre, **gras**, *italique*, - pour une puce, [texte](url) pour un lien, trois accents graves pour un bloc de code. Une ligne vide sépare les paragraphes et les tableaux s’écrivent avec des barres verticales.

Mis à jour le 7 novembre 2026

Markdown est une syntaxe légère pour mettre en forme du texte brut, convertie en HTML par les forums, wikis, dépôts de code et éditeurs de notes. Le socle commun est CommonMark ; GitHub (GFM) ajoute tableaux, cases à cocher et barré.

Structure du texte

Élément	Syntaxe Markdown	Résultat
titre de niveau 1 à 6	`# Titre`, `## Sous-titre`, `### …`	un dièse par niveau, suivi d’une espace
paragraphe	une ligne vide entre deux blocs de texte	un simple retour à la ligne ne crée pas de paragraphe
saut de ligne forcé	deux espaces en fin de ligne, ou `\` en fin de ligne	retour à la ligne dans le même paragraphe
ligne horizontale	`---` ou `***` seul sur une ligne	séparateur
citation	`> texte cité`	bloc en retrait ; `>>` pour imbriquer

Mise en forme en ligne

Élément	Syntaxe Markdown	Résultat
italique	`texte` ou `_texte_`	texte
gras	`texte` ou `__texte__`	texte
gras italique	`*texte*`	*texte*
barré (GFM)	`~~texte~~`	texte barré
code en ligne	`code`	`code`
lien	`[texte affiché](https://exemple.org)`	texte cliquable
lien avec infobulle	`[texte](https://exemple.org "Titre")`	infobulle au survol
image	`![description](image.png)`	image insérée, texte alternatif obligatoire
adresse brute	`<https://exemple.org>`	lien automatique
échapper un caractère	`\*`, `\#`, `\_`	affiche le caractère tel quel

Listes

Élément	Syntaxe Markdown	Remarque
liste à puces	`- élément` ou `* élément`	une ligne par élément
liste numérotée	`1. premier`, `2. deuxième`	la numérotation réelle suit l’ordre, même si l’on écrit 1. partout
sous-liste	indenter de 2 à 4 espaces	imbrication
case à cocher (GFM)	`- [ ] à faire`, `- [x] fait`	liste de tâches

Blocs de code et tableaux

Élément	Syntaxe Markdown	Remarque
bloc de code	trois accents graves ``` sur une ligne, le code, puis ```	ajouter le langage après les premiers accents : ```python pour la coloration
bloc de code (variante)	indenter chaque ligne de 4 espaces	sans coloration
tableau (GFM)	`\| Nom \| Âge \|` puis `\|---\|---\|` puis `\| Ana \| 32 \|`	la ligne de tirets est obligatoire ; `:---`, `:---:`, `---:` alignent à gauche, au centre, à droite
note de bas de page (extension)	`texte[^1]` puis `[^1]: note` en fin de document	non prise en charge partout

Exemple complet

# Compte rendu
Réunion du **7 novembre** avec *l’équipe*.

- [x] valider le budget
- [ ] relire le [cahier des charges](https://exemple.org)

> Décision : lancement le 1er décembre.

Erreurs fréquentes

Erreur : <code>#Titre</code> sans espace → Correct : <code># Titre</code> ; sans l’espace, beaucoup de convertisseurs n’y voient pas un titre.
Erreur : appuyer une fois sur Entrée pour changer de paragraphe → Correct : laisser une ligne vide, ou terminer la ligne par deux espaces pour un simple saut.
Erreur : <code>** texte **</code> avec des espaces intérieurs → Correct : <code>**texte**</code> collé aux astérisques.
Erreur : lien écrit <code>(texte)[url]</code> → Correct : crochets pour le texte, parenthèses pour l’adresse : <code>[texte](url)</code>.
Erreur : tableau sans ligne de séparation <code>|---|---|</code> → Correct : elle est obligatoire juste sous l’en-tête.
Erreur : oublier de refermer un bloc de code → Correct : la fin du document est alors affichée en code ; vérifier les trois accents graves de fermeture.

À retenir

Dièses pour les titres, astérisques pour l’emphase, tirets pour les listes, crochets puis parenthèses pour les liens, accents graves pour le code. Une ligne vide sépare les blocs ; en cas de doute, prévisualisez.