La version Markdown pour les agents est cassée
La page propose une version Markdown aux agents, par une réponse à Accept: text/markdown ou un <link rel="alternate" type="text/markdown">, mais cette version renvoie une erreur, un corps vide ou une page HTML. Les agents qui la demandent n'obtiennent rien d'utile.
Ce que cela signifie
La page propose du Markdown aux agents (en réponse à Accept: text/markdown ou via une copie liée), mais ce qui revient est une erreur, un corps vide ou une page HTML.
Pourquoi c'est important pour la recherche IA
Un agent qui voit le lien Markdown ou reçoit une réponse text/markdown lui fait confiance et peut ne pas revenir au HTML. Une copie cassée est pire que pas de copie : l'agent échoue, ou lit une page d'erreur comme si c'était votre contenu.
Cela arrive en général après une migration ou une refonte : les fichiers .md n'ont pas été déployés, une règle de réécriture pointe vers un ancien chemin, ou un middleware étiquette le HTML comme text/markdown.
Comment corriger
- Ouvrez l'URL indiquée dans les preuves et regardez le statut, le
Content-Typeet le corps. - Si la copie a disparu, redéployez-la ou supprimez la balise
<link rel="alternate" type="text/markdown">et l'en-têteLinkqui pointent vers elle. - Si la réponse est du HTML ou vide, corrigez la conversion pour qu'elle renvoie le texte de la page en Markdown avec
Content-Type: text/markdown. - Lancez « Revérifier » dans le rapport de la page pour confirmer le résultat.
Exemple
curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, 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é.