Pas de version Markdown pour les agents IA
Quand la page est demandée avec Accept: text/markdown, le serveur envoie du HTML, et la page ne renvoie vers aucune copie Markdown. Les agents IA lisent alors tout le HTML, menus, pieds de page et scripts compris. Servir une version Markdown est facultatif : c'est une convention récente, d'où le niveau P3.
Ce que cela signifie
Interrogée avec Accept: text/markdown, la page a répondu en HTML, et elle ne renvoie vers aucune copie Markdown (<link rel="alternate" type="text/markdown">). Les agents lisent alors tout le HTML, menus et scripts compris. Facultatif : le Markdown pour les agents est une convention récente, pas un standard.
Pourquoi c'est important pour la recherche IA
Les agents qui naviguent pour un utilisateur (et les outils qui chargent des pages dans le contexte d'un modèle) travaillent sur du texte, pas sur une mise en page. Une version Markdown propre d'une page est plusieurs fois plus légère que son HTML et garde les titres, listes et liens qui comptent. Certains CDN et frameworks répondent déjà à Accept: text/markdown avec une telle version, et llmstxt.org propose une copie .md à côté de chaque page.
Rien ne casse sans elle : les robots lisent toujours le HTML. C'est une amélioration peu coûteuse une fois corrigés les constats sur l'accès, robots.txt et le contenu.
Comment corriger
- Choisissez une façon de servir le Markdown : répondre à
Accept: text/markdownà l'URL même de la page, ou publier une copie comme/guide/index.md. - Sur un CDN, activez sa conversion Markdown pour les agents s'il en propose une. Dans un framework, ajoutez un middleware qui renvoie la version Markdown quand l'en-tête
Acceptdemandetext/markdown. - Envoyez
Content-Type: text/markdown; charset=utf-8et, si l'URL est la même que celle de la page HTML,Vary: Accept. - Liez la copie depuis le head HTML avec
<link rel="alternate" type="text/markdown">, pour que les agents qui ne négocient pas le contenu la trouvent aussi. - Lancez « Revérifier » dans le rapport de la page pour confirmer le résultat.
Exemple
<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">
# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept Comment confirmer le correctif
Après la modification, cliquez sur « Revérifier » dans le rapport : il indique ce qui a été corrigé et comment le score a évolué.