Retour aux articles

Markdown est partout, et ça a commencé par un README

Markdown 8 min de lecture

Avez-vous remarqué que Markdown est progressivement devenu le format de document de facto ?

Je l'ai remarqué un peu par hasard. Un collègue qui n'écrit pas une ligne de code m'a demandé pourquoi son texte affichait des dièses partout. Il avait copié une réponse d'un assistant IA dans un mail. Le Markdown était arrivé chez lui sans qu'il sache ce que c'était.

Pendant longtemps, pour moi, Markdown c'était le README.md à la racine d'un repo. Aujourd'hui je le croise partout, y compris chez des gens qui n'ont jamais ouvert un terminal. J'ai eu envie de remonter le fil pour comprendre comment on en est arrivés là.

2004 : un format pensé pour être lu brut

Markdown a été présenté le 15 mars 2004 par John Gruber, sur son blog Daring Fireball. Aaron Swartz, qui avait alors 17 ans, l'a aidé comme bêta-testeur. L'idée de départ était modeste : écrire pour le web sans taper du HTML.

Concrètement, Markdown était un script Perl pensé comme plugin pour Movable Type, l'outil de blog qu'utilisait Gruber. Michel Fortin l'a porté en PHP dès la première année, et Gruber recommandait lui-même ce portage sur la page officielle. En tant que développeur PHP, ce détail me fait sourire : Markdown parlait notre langage presque depuis le début.

Le principe qui a tout décidé, c'est qu'un fichier Markdown doit rester lisible même s'il n'est jamais converti. Un titre avec un dièse, une liste avec des tirets, du gras entre astérisques. On reprenait des habitudes qui existaient déjà dans les mails en texte brut et sur les forums.

C'est ce choix qui explique sa longévité. Un fichier .md ouvert dans le Bloc-notes, dans vim ou dans un terminal reste compréhensible. Peu de formats peuvent en dire autant.

Repère

Détail

Présentation publique

15 mars 2004, sur Daring Fireball

Créateur

John Gruber

Bêta-testeur

Aaron Swartz, 17 ans à l'époque

Première implémentation

Script Perl, plugin pour Movable Type

Premier portage

PHP, par Michel Fortin

Inspiration principale

Les mails en texte brut

2008-2014 : la langue des développeurs

Entre 2008 et 2014, Markdown devient l'outil d'écriture par défaut des développeurs, presque sans qu'on le choisisse.

Stack Overflow l'adopte dès son lancement en 2008. GitHub en fait la base de ses README, puis de ses issues, pull requests et wikis, avec sa propre variante : GitHub Flavored Markdown. Les générateurs de sites statiques suivent, et les notebooks IPython (futur Jupyter) l'utilisent pour leurs cellules de texte.

Année

Outil

Ce qu'il apporte

2014

MkDocs

De la documentation technique entièrement en .md

2014

CommonMark

Une spécification pour unifier les dialectes

2013

Hugo

Des sites statiques en Go, contenu en Markdown

2011

IPython Notebook

Texte en Markdown entre les cellules de code

2008

Jekyll

Le blog de développeur en fichiers .md

2008

Stack Overflow

Questions et réponses rédigées en Markdown

2008

GitHub

README, issues, PR, wikis

Dans un repo, on ne s'arrête pas au README. Il y a le CHANGELOG.md, le CONTRIBUTING.md, le SECURITY.md, et ce dossier .github caché qui contient les modèles d'issues et de pull requests. Tout ce qui entoure le code s'écrit en Markdown.

Le revers, c'est que chacun ajoute ses extensions. Tableaux, cases à cocher, blocs de code avec coloration : rien de tout ça n'était dans la version de 2004. CommonMark naît en 2014 justement parce qu'un même fichier ne s'affichait pas pareil d'un outil à l'autre. Ce problème-là ne nous a jamais vraiment quittés.

2015-2022 : un pied dehors

Pendant ces années, Markdown commence à sortir du repo, mais par petites touches.

Slack et Discord acceptent une partie de la syntaxe : gras, italique, code. Notion et d'autres éditeurs transforment un dièse tapé en début de ligne en titre. Obsidian, lancé en 2020, construit toute son approche sur des fichiers .md stockés en local, et attire beaucoup de gens qui ne sont pas développeurs.

En 2022, Google Docs se met à détecter automatiquement la syntaxe Markdown pendant la frappe. C'est un signe : le format n'est plus réservé aux techniciens. Mais la plupart des utilisateurs s'en servent sans savoir que ça porte un nom.

Outil

Ce qu'il fait avec Markdown

Slack, Discord

Une partie de la syntaxe : gras, italique, code

Notion

Transforme la syntaxe tapée en mise en forme

Obsidian (2020)

Des notes stockées en fichiers .md locaux

Google Docs (2022)

Détection automatique pendant la frappe

2023 et après : l'IA fait le reste

Ce qui a tout accéléré, ce sont les assistants IA. Ils répondent en Markdown par défaut : titres, listes, gras, tableaux, blocs de code. Des millions de personnes ont commencé à lire du Markdown tous les jours, souvent sans le savoir.

En juillet 2024, Google Docs ajoute l'import et l'export en .md, ainsi que le collage depuis Markdown (annonce Google Workspace). Google cite surtout les rédacteurs techniques, mais tout le monde en profite.

Côté code, le Markdown change même de lecteur. On écrit maintenant des fichiers destinés aux agents IA plutôt qu'aux humains. Chaque outil avait son propre fichier (CLAUDE.md, .cursorrules, GEMINI.md…), puis OpenAI publie AGENTS.md en août 2025 comme format commun. En décembre 2025, plus de 60 000 projets open source l'utilisaient selon OpenAI, qui l'a confié à la Linux Foundation (annonce).

Le README était écrit pour un humain qui découvre un projet. AGENTS.md est écrit pour une machine qui va travailler dessus. Le format est le même.

README.md

AGENTS.md

Lecteur

Un humain

Un agent IA

Rôle

Présenter le projet

Donner les consignes pour travailler dessus : installation, tests, conventions

Généralisé

Avec GitHub, à partir de 2008

Publié par OpenAI en août 2025

Adoption

Presque tous les repos GitHub

Plus de 60 000 projets open source fin 2025

Le support natif ne suit pas

Markdown est partout, mais il n'est pas compris partout. C'est là que ça coince.

Je colle un tableau Markdown dans un outil, il s'affiche proprement. Dans un autre, je récupère des barres verticales et des tirets en vrac. Un mail rédigé avec un assistant IA arrive chez le destinataire plein d'astérisques. Un même fichier .md ne rend pas pareil sur GitHub, dans VS Code et dans Obsidian, parce que chacun gère ses propres extensions.

LinkedIn, par exemple, ne l'interprète pas du tout. Si vous voulez du gras dans un post, il faut passer par des caractères Unicode, ce qui pose d'autres problèmes d'accessibilité.

Le problème des dialectes ne date pas d'hier. En 2014, Jeff Atwood, cofondateur de Stack Overflow, et John MacFarlane, créateur de Pandoc, publient une spécification sous le nom de « Standard Markdown ». Gruber refuse que le mot Markdown apparaisse dans le nom, et le projet devient CommonMark. La version 1.0 de cette spécification n'est toujours pas sortie.

Le format est devenu universel côté écriture. Côté affichage, chaque outil fait encore ses propres choix.

2025 : le Bloc-notes de Windows et Apple Notes passent au Markdown

C'est le signe le plus clair que Markdown est sorti du monde des développeurs : les deux éditeurs de texte les plus basiques, installés sur des centaines de millions de machines, l'ont adopté la même année.

Le Bloc-notes de Windows lit et écrit le Markdown

Fin mai 2025, Microsoft commence à déployer auprès des Windows Insiders une mise à jour du Bloc-notes avec une mise en forme légère : gras, italique, liens, listes, titres. Le Bloc-notes accepte la saisie en Markdown et ouvre les fichiers .md. Un bouton dans la barre d'état permet de passer de la vue mise en forme à la vue syntaxe, et on peut désactiver la fonction dans les paramètres.

En novembre 2025, une nouvelle préversion ajoute les tableaux, à insérer depuis la barre d'outils ou directement en syntaxe Markdown.

Pour un outil resté un simple éditeur de texte brut pendant des décennies, le changement est énorme. Il n'est d'ailleurs pas passé inaperçu : une partie des utilisateurs a protesté, attachée à un Bloc-notes sans fioritures.

Apple Notes importe et exporte en Markdown

Apple a choisi une autre approche. Avec iOS 26, iPadOS 26 et macOS Tahoe 26, Notes sait importer un fichier .md et exporter une note en Markdown. Les titres, listes, liens, le gras et l'italique sont convertis en texte enrichi à l'import. La documentation actuelle d'Apple mentionne aussi la copie d'une note en Markdown et le collage de Markdown dans Notes.

En revanche, on n'écrit pas en Markdown dans Notes. La conversion se fait à l'entrée et à la sortie, et entre les deux la note reste au format d'Apple.

Bloc-notes (Windows)

Apple Notes

Écrire directement en syntaxe Markdown

Oui

Non

Basculer entre vue mise en forme et syntaxe

Oui

Non

Fichiers .md

Ouverts et édités tels quels

Importés, convertis, exportables

Tableaux

Oui, en préversion depuis novembre 2025

Non précisé

Où en sont les outils grand public

Outil

Ce qu'il fait avec Markdown

Depuis

Bloc-notes (Windows 11)

Affiche et édite le Markdown, bascule vue mise en forme / syntaxe, tableaux

2025

Apple Notes (iOS 26, macOS Tahoe)

Import et export .md, conversion en texte enrichi

2025

Google Docs

Détection à la frappe, puis import, export et collage

2022, puis 2024

LinkedIn

Aucun rendu

Jamais

Ce que je retiens : Microsoft a fait du Markdown un format natif dans son éditeur le plus simple, Apple l'a traité comme un format d'échange. Deux visions, et toujours pas de comportement commun.

Et maintenant ?

Je ne crois pas qu'on verra un jour un Markdown unique, rendu à l'identique partout. Le format a gagné justement parce qu'il était simple et que chacun pouvait l'étendre. Cette liberté a un prix, et on le paie à chaque copier-coller.

Ce qui me frappe, c'est le chemin parcouru. Il y a vingt ans, c'était une astuce pour éviter d'écrire du HTML. Il y a dix ans, c'était notre format à nous, dans les repos. Aujourd'hui, mes clients en reçoivent sans le savoir, et je rédige des fichiers .md pour expliquer mes projets à des agents IA.

En attendant que les outils rattrapent les usages, j'écris en Markdown à peu près partout. Y compris dans des endroits où personne ne le lira comme tel.

Sources

Partager cet article

J’aimerais utiliser Google Analytics pour savoir quelles pages vous sont utiles. Rien n’est déposé sans votre accord. En savoir plus