Markdown : guide du débutant
Publié le 25/09/2025 · 3 min de lecture · Outils pour développeurs
Daniel Okonkwo — Développeur front-end et rédacteur Tech chez OneKitly
Performance web · Formats de fichiers
Vérifié à partir de 2 sources
Le markdown est une façon simple de mettre en forme du texte brut avec de la ponctuation : # pour les titres, ** pour le gras, * pour l'italique, - pour les listes à puces, et [texte](url) pour les liens. Tu l'écris en texte normal et il se convertit en HTML mis en forme. Il est utilisé sur GitHub, les messageries, les outils de notes et les sites statiques car il est lisible tel quel et rapide à taper.
Mets en forme du texte brut avec quelques symboles : # pour les titres, ** pour le gras, - pour les listes. Voici ce qu'est le markdown, la syntaxe de base, pourquoi il est partout, et les pièges.
Ce qu'est le markdown
Le markdown est un langage de balisage léger : un ensemble de conventions en texte brut qu'un programme transforme en sortie mise en forme, d'ordinaire du HTML. L'idée est que le texte brut reste lisible — un titre marqué d'un # ou une liste marquée de tirets paraît structuré avant même le rendu. Tu obtiens la clarté de la mise en forme sans quitter un fichier texte ni toucher la souris, d'où son adoption rapide par écrivains et développeurs.
La syntaxe de base
L'essentiel tient en quelques lignes. Un # crée un titre, et plus de dièses font des sous-titres plus petits. Deux astérisques autour d'un texte le mettent en **gras**, un seul en *italique*. Les lignes commençant par - ou * deviennent des puces, celles commençant par 1. une liste numérotée. Les liens s'écrivent [texte visible](l-url), et une image de même avec un ! devant. Les accents graves marquent le `code`. Maîtrise cela et tu formates presque tout.
Pourquoi il est partout
Le markdown s'est répandu car il est portable et pérenne. Ce n'est que du texte : il s'ouvre dans n'importe quel éditeur, se copie proprement entre applications et restera lisible dans des décennies. GitHub l'emploie pour les README et les tickets, Reddit et les forums pour les messages, les messageries comme Slack et Discord pour la mise en forme, et les outils de notes et générateurs de sites statiques pour des documents entiers. Apprends-le une fois et la même poignée de symboles marche partout.
Pièges et variantes
Deux choses piègent les débutants. Les lignes vides comptent : les paragraphes ont besoin d'une ligne vide entre eux, et une liste en demande souvent une avant pour s'afficher. Et le markdown n'est pas un standard unique — il existe en « variantes ». Les fonctions de base marchent partout, mais les extras comme tableaux, listes de tâches et texte barré sont des extensions que certains outils gèrent et d'autres non. En cas de doute, le Markdown de GitHub et la spécification CommonMark sont les deux références les plus sûres.
Questions fréquentes
- Qu'est-ce que le Markdown ?
- Une syntaxe de mise en forme en texte brut qui se convertit en HTML avec des symboles simples comme # et **.
- Comment mettre du texte en gras en Markdown ?
- Entoure-le de doubles astérisques : **comme ceci**.
- Où utilise-t-on le Markdown ?
- GitHub, messageries, outils de notes, forums et générateurs de sites statiques, entre autres.
Articles qui pourraient t'intéresser
Tous les guides →Outils similaires
Sources
Tu as repéré une erreur dans cet article ?