Docs

Faut-il servir une version Markdown de mes pages aux agents IA ?

Facultatif, et jamais à la place d'un bon HTML. Google dit qu'aucun Markdown ni fichier texte pour l'IA n'est nécessaire pour apparaître dans sa recherche. Une version Markdown aide les agents comme Claude Code à lire votre page avec moins de tokens ; elle doit alors dire exactement ce que dit la page HTML.

Données clés

Qui lit vraiment la version Markdown ?

Surtout les agents de codage et les outils d'IA qui récupèrent une page à la demande, et non les robots d'exploration de la recherche, qui décident de ce qui est cité.

LecteurCe qu'il litLe Markdown aide-t-il ?
Recherche Google, Aperçus IA, Mode IAVos pages HTMLNon : Google dit ne pas avoir besoin de Markdown
Agents de codage comme Claude CodeDu Markdown lorsque le site le propose sur Accept: text/markdownOui : moins de tokens, texte plus propre
Lecteurs de documentation techniqueUne copie .md de chaque pageOui : la documentation développeur d'OpenAI en propose une en ajoutant .md à l'URL
llms.txtUn court fichier d'indexPas pour la recherche Google, qui l'ignore

Servir du Markdown aux robots, est-ce du cloaking ?

Non, si le contenu est le même. Google définit le cloaking comme le fait de montrer un contenu différent aux internautes et aux moteurs de recherche, dans l'intention de manipuler le classement et de tromper les utilisateurs.

Une copie Markdown qui reprend le même texte, les mêmes prix et les mêmes affirmations que la page HTML est un autre format, pas un autre contenu. Le risque, c'est une page Markdown avec des affirmations en plus, écrites seulement pour l'IA.

Mon site d'entreprise en a-t-il besoin, ou seulement les sites de documentation ?

La documentation et les outils pour développeurs y gagnent le plus, car leurs lecteurs sont souvent des agents de codage. Un site qui vend à des personnes gagne davantage avec des pages HTML complètes, rendues côté serveur, qui répondent aux questions de l'acheteur.

Si votre site est déjà derrière Cloudflare, sur une offre payante, activer la fonction est une simple option, sans coût supplémentaire. Construire et maintenir à la main une seconde copie de chaque page vaut rarement la peine.

Comment vérifier ce que reçoit un agent ?

Demandez la page avec l'en-tête Accept du Markdown et lisez les en-têtes de la réponse. Elle doit renvoyer content-type: text/markdown et vary: accept, pour que les caches gardent les deux versions séparées.

# Ce que reçoit un agent qui demande du Markdown
curl -s -H "Accept: text/markdown" https://www.example.com/pricing | head -20

# Les en-têtes qui doivent revenir avec
curl -sI -H "Accept: text/markdown" https://www.example.com/pricing | grep -i -E "content-type|vary"
# attendu : content-type: text/markdown ... et vary: accept

Comment easyIndex traite-t-il le Markdown ?

easyIndex audite chaque page lorsque votre agent de codage la soumet, puis vérifie la page HTML publiée sur le site en ligne, car c'est elle que lisent les robots de recherche et d'IA. La page est écrite une seule fois, pour l'indexation : il n'existe donc pas de seconde version qui pourrait diverger.

Étape par étape

  1. Corriger d'abord le HTML. Vérifiez que chaque page publique a tout son texte dans le HTML rendu côté serveur et qu'elle figure dans le sitemap.
  2. Décider qui a besoin du Markdown. N'ajoutez une version Markdown que si des agents de codage ou des développeurs lisent vos pages, comme pour une documentation ou des API.
  3. Choisir une seule méthode. Activez Markdown for Agents de Cloudflare, ou demandez à votre agent de codage de servir le même contenu en Markdown sur Accept: text/markdown.
  4. Garder un contenu identique. Générez le Markdown à partir de la même source que le HTML, pour que les prix et les affirmations ne divergent jamais.
  5. Tester avec curl. Demandez une page avec Accept: text/markdown et vérifiez que content-type et vary: accept reviennent.

Erreurs fréquentes

  • Écrire des pages Markdown avec des affirmations absentes de la page HTML, ce que Google appelle du cloaking.
  • Créer des copies Markdown alors que les pages HTML n'affichent leur texte que dans le navigateur.
  • Servir du Markdown sur la même URL sans vary: accept, si bien qu'un cache le remet à des navigateurs.
  • Espérer qu'un fichier llms.txt ou des copies Markdown fassent monter le classement dans Google, qui dit les ignorer.

Comment easyIndex le résout

Votre agent de codage rédige et publie chaque page dans votre dépôt, guidé via MCP avec les règles en vigueur ; easyIndex audite la page à sa soumission, vérifie lui-même la page HTML en ligne, puis montre quelles pages les robots d'IA ont lues et combien de visiteurs venus d'assistants IA chacune a apportés. 30 $US par site et par mois, avec un essai gratuit de 7 jours.

Questions fréquentes

Markdown for Agents, est-ce la même chose que llms.txt ?

Non. llms.txt est un fichier d'index à la racine du site ; Markdown for Agents renvoie une version Markdown de n'importe quelle page lorsque la requête demande text/markdown.

Markdown for Agents fonctionne-t-il avec l'offre gratuite de Cloudflare ?

Non. La documentation de Cloudflare cite les offres Pro, Business et Enterprise, ainsi que les clients SSL for SaaS, sans coût supplémentaire.

ChatGPT citera-t-il davantage mon site si je sers du Markdown ?

Personne ne l'a démontré. La documentation des robots d'OpenAI ne parle pas de Markdown, et les citations dépendent de l'exploration de la page et de la réponse qu'elle apporte à la question.

Mon agent de codage peut-il le faire sans Cloudflare ?

Oui. Une route ou un middleware peut renvoyer le même contenu en Markdown lorsque l'en-tête Accept le demande, avec vary: accept dans la réponse.

Lire la suite

Dernière vérification le .

Servir du Markdown aux agents IA : utile ou inutile ?