Aller au contenu
OneKitly

Markdown : guide du débutant

Publié le 25/09/2025 · 3 min de lecture · Outils pour développeurs

Daniel Okonkwo

Daniel OkonkwoDéveloppeur front-end et rédacteur Tech chez OneKitly

Performance web · Formats de fichiers

Vérifié à partir de 2 sources

Voir le profil
En bref

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.

Markdown vers HTMLVois ton Markdown rendu en direct et copie le HTML propre qui va avec.Essayer l'outil

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 ?