Markdown pour Agents

Comprendre le facteur « Markdown pour Agents »

Markdown for Agents permet à un client de demander une version Markdown d'une page Web en envoyant Accept: text/markdown dans sa requête HTTP. Lorsque le site prend en charge la négociation de contenu, le serveur renvoie du Markdown simplifié au lieu du HTML. Le format peut supprimer le code d’interface et rendre le contenu principal plus facile à lire pour un agent demandeur. Un client qui effectue une requête HTML ordinaire ne reçoit pas cette variante. Cloudflare documente une implémentation qui convertit une réponse d'origine HTML et renvoie Content-Type: text/markdown avec Vary: Accept afin que les caches puissent distinguer les deux versions.

Détails de l’impact

Impact : faible et conditionnel pour la visibilité dans les IA. Une réponse Markdown propre peut rendre l'extraction plus efficace pour un client qui envoie l'en-tête et utilise le texte renvoyé. Cela ne peut pas aider un client qui ne demande jamais Markdown. Il n’existe aucune preuve publiée démontrant que l’activation du Markdown négocié par le contenu augmente en soi les citations, la fréquence des recommandations ou l’inclusion dans les principaux systèmes de réponse d’IA. Google affirme que les fichiers texte spéciaux Markdown ou AI ne sont pas nécessaires pour les capacités d'IA générative de la recherche Google. La qualité du contenu, la découvrabilité et l'accès à la page ordinaire sont toujours importants. Documentation Cloudflare Markdown pour les agents et Guide d'optimisation de l'IA de Google.

Détails des preuves et du consensus

Preuve : Faible. Consensus : mitigé pour un gain direct de visibilité dans les IA. Le comportement HTTP est réel et testable : Cloudflare documente les en-têtes de requête et de réponse et propose sa propre documentation pour les développeurs dans des formats conviviaux pour les agents. Cela prouve qu'un client peut recevoir Markdown là où le service est activé. Cela ne prouve pas que les fonctionnalités de Google AI, ChatGPT ou d'autres moteurs de réponse majeurs demandent cette représentation ou la classent plus haut. La documentation du robot d'exploration d'OpenAI explique l'accès du robot via robots.txt mais ne documente pas de préférence pour cet en-tête Accept. Le résultat mesuré à vérifier est si un client cible utilise la représentation et extrait le contenu correct, et non si une réponse Markdown existe simplement. Documentation Cloudflare Markdown pour les agents, Documents Cloudflare pour les agents et Documentation du robot d'exploration d'OpenAI.

Recommandation

Proposez une représentation Markdown si votre audience comprend des agents ou des applications qui en font la demande et que la conversion préserve le contenu utile de la page. Gardez les titres, les listes, les tableaux, les liens et le contexte source précis. Assurez-vous que la page HTML normale reste complète et disponible. Servez le bon Content-Type, faites varier les caches par Accept et inspectez les pages représentatives après les modifications du modèle. La conversion peut supprimer la navigation et le style, ce qui est utile, mais elle peut également révéler un contenu manquant ou mal formé si la source HTML est faible. Évitez de promettre une amélioration de la recherche par l'IA sans preuve des clients qui vous intéressent.

Plateformes IA

Google AI Overviews et AI Mode : Google affirme qu'un format Markdown spécial n'est pas nécessaire pour la recherche et ses fonctionnalités d'IA. Guide d'optimisation de l'IA de Google

ChatGPT : OpenAI ne publie pas d'exigence relative au Markdown négocié sur le contenu dans ses instructions pour les robots d'exploration. Documentation du robot d'exploration d'OpenAI

Agents qui demandent Markdown : ils peuvent utiliser la représentation si le site répond à Accept: text/markdown ; Cloudflare documente un tel chemin de requête pour ses documents de développement. L'effet réel dépend du comportement de chaque client. Documents Cloudflare pour les agents

Instructions d’audit

1. Demandez normalement une page représentative, puis demandez la même URL avec Accept: text/markdown. Vérifiez si la deuxième réponse est Markdown et contient Content-Type: text/markdown et Vary: Accept.
2. Comparez les deux versions pour le titre de la page, le texte principal, les titres, les liens clés, les tableaux et les dates. Signalez le contenu manquant, les liens brisés ou les résultats de conversion obsolètes.
3. Confirmez qu'un agent que vous avez l'intention de prendre en charge envoie réellement la demande Markdown. Revérifiez quelques types de pages après les modifications et suivez les effets des réponses IA séparément de la livraison réussie du format.