Markdown — fichier .md

Le Markdown, créé par John Gruber en 2004, propose une syntaxe minimaliste pour mettre en forme du texte (titres, listes, gras, liens) tout en restant parfaitement lisible tel quel, sans rendu — l’inverse de l’approche du HTML ou du RTF où le balisage nuit fortement à la lisibilité brute.

Ce format n’a aucune signature binaire : c’est du texte pur, sans en-tête ni structure imposée.

Devenu le standard de facto de la documentation technique (README de projets logiciels, wikis, notes personnelles), le Markdown existe en plusieurs variantes (CommonMark, GitHub Flavored Markdown) qui étendent la syntaxe originale de façons parfois incompatibles entre elles, un point de friction connu de l’écosystème malgré son enregistrement officiel à l’IANA depuis 2016.

CommonMark, publié en 2014 par plusieurs figures majeures de l’écosystème (dont un cofondateur de GitHub et de Stack Overflow), est né précisément du constat que la spécification originale de Gruber laissait trop de cas ambigus non tranchés, chaque implémentation les résolvant alors à sa manière.

GitHub Flavored Markdown ajoute par-dessus CommonMark des extensions désormais très répandues (tableaux, cases à cocher, blocs de code avec coloration syntaxique) qui ne font pourtant partie d’aucune norme officielle unique, un fichier .md pouvant ainsi s’afficher différemment selon la plateforme qui l’interprète.

De nombreux générateurs de sites statiques (Jekyll, Hugo, Astro) utilisent d’ailleurs directement des fichiers Markdown comme source de contenu éditorial, chaque page du site étant rédigée dans ce format puis transformée en HTML au moment de la génération plutôt qu’éditée directement dans un système de gestion de contenu traditionnel.