Markdown

Qu'est-ce que le Markdown ?

Le Markdown est une syntaxe d'écriture qui note la structure d'un texte avec quelques signes simples. Il est devenu le format d'échange privilégié entre les sites et les agents d'IA, qui y lisent la hiérarchie sans avoir à interpréter du HTML.

Une structure lisible sans balises

Un dièse pour un titre, un tiret pour une puce, des crochets pour un lien : le Markdown note la hiérarchie d'un document en restant lisible tel quel. C'est ce qui en fait le format d'écriture par défaut de la documentation technique.

Son intérêt pour la visibilité est plus récent : un agent qui récupère une page HTML doit d'abord en extraire le texte, et ce qu'il obtient dépend de son extracteur. Une version Markdown lui donne le plan exact, sans nav ni pied de page.

Le servir sur un site

• Une même page accessible en ajoutant .md à son URL : c'est l'adresse qu'un agent devine.
• Un en-tête de provenance en tête de fichier — titre, source, auteur, date — pour que la citation reste attribuée.
• Un type de contenu text/markdown et une mise en cache, comme pour n'importe quelle ressource statique.

Exemple concret

La documentation d’un éditeur de logiciel métier s’affiche dans une visionneuse qui reconstruit ses tableaux en JavaScript. Récupérée par un agent, la page ressort sans le tableau des paramètres, avec le menu et le pied de page collés au texte. Une version .md de chaque rubrique est publiée à côté : titre en tête, paramètres en liste, date de dernière révision. Le fichier tient en quelques kilo-octets et se lit sans navigateur.

À retenir

Servir ses pages en Markdown coûte peu et supprime une incertitude : ce que le modèle lit devient exactement ce que vous avez écrit.