En une vingtaine d’années, un petit langage de balisage inventé par John Gruber pour écrire des e-mails lisibles est devenu le format d’écriture par défaut des développeurs, des preneurs de notes, des documentalistes et de plateformes entières comme GitHub ou Reddit. Pourquoi Markdown a-t-il gagné là où des formats plus puissants ont échoué ?
Écrire sans quitter le texte
Markdown ajoute une mise en forme minimale à du texte brut : # pour un titre, **gras**, *italique*, - pour une liste, [texte](url) pour un lien. La règle de conception de Gruber était limpide : un document Markdown doit rester parfaitement lisible tel quel, sans être « rendu ». C’est cette contrainte qui fait toute la différence.
- Portable — du texte brut, aucun format binaire propriétaire, lisible partout.
- Durable — un fichier
.mdécrit aujourd’hui sera lisible dans trente ans, sur n’importe quel système. - Convertible — vers HTML, PDF, Word, LaTeX, ePub via des outils comme Pandoc.
- Versionnable — lisible ligne à ligne par Git, donc parfait pour la collaboration et l’historique.
D’un standard flou à CommonMark
Le succès a d’abord failli tuer Markdown : chaque outil l’interprétait à sa façon, si bien qu’un même fichier pouvait rendre différemment ici et là. La spécification CommonMark a mis de l’ordre en fixant un comportement rigoureux et testable. Par-dessus, des extensions comme GitHub Flavored Markdown (GFM) ont ajouté les tableaux, les listes de tâches et le barré — couvrant enfin les besoins réels. Aujourd’hui, écrire en Markdown, c’est écrire pour tout un écosystème cohérent.
Là où Markdown atteint ses limites
Markdown n’est pas conçu pour la mise en page complexe : colonnes, encadrés riches, références croisées automatiques, numérotation de figures. Pour un livre technique, une norme ou une documentation très structurée, deux alternatives prennent le relais :
- AsciiDoc — plus riche, pensé pour les ouvrages et les manuels, avec admonitions, includes et attributs.
- reStructuredText — le format historique de la documentation Python, très structuré, au cœur de Sphinx.
Mais pour 90 % des notes, articles et pages de documentation, cette puissance supplémentaire est un coût inutile. La simplicité de Markdown est précisément ce qui le rend adopté.
En pratique
Trois habitudes suffisent à en tirer le meilleur : apprendre les cinq symboles de base (titre, gras, liste, lien, code), s’en tenir à CommonMark + GFM pour l’interopérabilité, et garder Pandoc sous la main pour convertir vers le format attendu par vos destinataires. Vos notes deviennent alors une source unique, à partir de laquelle vous produisez du HTML pour le web, du PDF pour l’impression, du Word pour un client.
À retenir
Markdown a gagné parce qu’il disparaît : il vous laisse écrire au lieu de vous imposer une interface. Apprenez ses cinq symboles, adoptez CommonMark, gardez Pandoc à portée — et vos textes deviennent portables, durables et convertibles à volonté, pour des décennies.