{"id":"ia.markdown-negotiation","name":"Content negotiation (text/markdown)","verify":{"command":"curl -s -o /dev/null -w '%{content_type}\\n' -H 'Accept: text/markdown' https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.markdown-negotiation","expect":"text/markdown"},"fix":{"steps":[{"action":"Generate a Markdown version of each content page.","order":1,"language":null,"code_example":null},{"action":"Return the Markdown version with Content-Type text/markdown when the Accept header asks for it.","order":2,"language":null,"code_example":null},{"action":"Add Vary: Accept so that caches keep the two formats apart.","order":3,"language":"text","code_example":"Content-Type: text/markdown; charset=utf-8\nVary: Accept"}],"summary":"Return Markdown when a request sends Accept: text/markdown, and add Vary: Accept.","skill":{"name":"ai-content-discovery","anchor":"ia.markdown-negotiation"}},"category":"discovery","aggregate":null,"references":[{"title":"HTTP Content Negotiation - MDN","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Content_negotiation"},{"title":"RFC 9110 - HTTP Semantics: Content Negotiation","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9110#name-content-negotiation"},{"title":"Cloudflare: Introducing Markdown for Agents","kind":"guide","url":"https://blog.cloudflare.com/markdown-for-agents/"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-09","url":"https://www.agentready.org/#read"},"why":"AI agents fetch pages programmatically and benefit from machine-readable formats. Serving Markdown via Accept: text/markdown allows agents to consume structured content without HTML parsing overhead, saving up to 80% of tokens while preserving headings, links, and emphasis.","profiles":["ai_search_visibility"],"score_role":"bonus","legacy_id":"1.7","i18n":{"nl":{"name":"Content negotiation (text/markdown)","steps":["Genereer een Markdown-versie van elke contentpagina.","Geef de Markdown-versie terug met Content-Type text/markdown als de Accept-header erom vraagt.","Voeg Vary: Accept toe, zodat caches de twee formaten gescheiden houden."],"why":"AI-agents halen pagina's programmatisch op en hebben baat bij machineleesbare formaten. Markdown via Accept: text/markdown bespaart tot 80% tokens en houdt koppen, links en nadruk intact.","fix_summary":"Geef Markdown terug als een request Accept: text/markdown stuurt, en voeg Vary: Accept toe.","verify_expect":"text/markdown"}},"ar_practice_ids":["AR-READ-09"],"strength":"MAY","ar_mapping":"full","evidence_type":"measured_study","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.markdown-negotiation","maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}