---
title: "CF-MARKDOWN-NEGOTIATION: Markdown by Accept | Agent Ready Checklist"
description: "CF-MARKDOWN-NEGOTIATION (CLOUDFLARE, Read layer): Markdown by Accept. What it asks, the evidence, the command that verifies it and the fix on 19 platforms."
canonical: https://agentreadychecklist.com/checklist/cf-markdown-negotiation
site: "Agent Ready Checklist"
last_updated: 2026-11-05
section: "Checklist"
---
# CF-MARKDOWN-NEGOTIATION: Markdown by Accept | Agent Ready Checklist
> CF-MARKDOWN-NEGOTIATION (CLOUDFLARE, Read layer): Markdown by Accept. What it asks, the evidence, the command that verifies it and the fix on 19 platforms.
Source: https://agentreadychecklist.com/checklist/cf-markdown-negotiation
Site: Agent Ready Checklist
Last reviewed: 2026-11-05
Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search)
Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free).
# CF-MARKDOWN-NEGOTIATION: Markdown by Accept
CF-MARKDOWN-NEGOTIATION is a Cloudflare scanner check on the read layer: Return a markdown representation when a request sends Accept: text/markdown, with Content-Type text/markdown; HTML stays the default. It applies to content and docs sites. 19 of 19 platforms have a recipe below, 9 of them workarounds. The kit check markdown-negotiation tests it with one command.
## The requirement
Identifier
CF-MARKDOWN-NEGOTIATION
Level
CLOUDFLARE
Layer
Read
Applies to
content and docs sites
Checked by
Ora, matched on this site, Cloudflare markdownNegotiation, Verify Kit markdown-negotiation
Ora check
[markdown-negotiation-vary, markdown-negotiation](#ora)
The statement
Return a markdown representation when a request sends Accept: text/markdown, with Content-Type text/markdown; HTML stays the default.
## Why
- Cloudflare Radar found 3.9% of scanned sites pass markdown negotiation.primary source, 2026-04-17: [blog.cloudflare.com/agent-readiness/](https://blog.cloudflare.com/agent-readiness/), read 2026-11-04
- Cloudflare reports up to 80% token reduction for markdown against HTML in some cases.vendor claim, 2026-04-17: [blog.cloudflare.com/agent-readiness/](https://blog.cloudflare.com/agent-readiness/), read 2026-11-04
- The AgentReady spec says content negotiation did not change whether agents succeeded in the studies; it carries no MUST or SHOULD for it.primary source: [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md), read 2026-11-04
## How to verify
### [Markdown negotiation and mirror](https://agentreadychecklist.com/kit/markdown-negotiation/)
```bash
curl -fsSL https://agentreadychecklist.com/kit/verify.sh | bash -s -- https://example.com --only=markdown-negotiation
```
Sends Accept: text/markdown and checks the response Content-Type starts with text/markdown and Vary includes Accept; separately looks for or a Link header.
**It cannot prove:** Does not compare the markdown to the HTML for drift; a FAIL is not a spec violation because AgentReady does not require negotiation.
### The one-line version
curl -s -o /dev/null -w "%{content\_type}" -H "Accept: text/markdown" must start with text/markdown.
## Verify with Ora
2 checks in Ora's catalogue (contract 1.38.0, read 2026-11-05) read this row. Each entry says what the check looks at and why this page lists it.
- `markdown-negotiation-vary` Markdown content negotiation (acceptmarkdown.com) Tests that the homepage serves markdown when asked and HTML for browsers, with Vary: Accept on the markdown response. A markdown route on a docs page alone does not satisfy it. A bonus check. Access, 1 point, bonus, recommended; catalogue applicability domain-only. Listed because: same name, `negotiation`.
- `markdown-negotiation` Markdown agent docs Looks for docs available as markdown through content negotiation or .md routes. Marked emerging. Access, 1 point, emerging; catalogue applicability domain-only. Listed because: same id, `markdown-negotiation`.
### Run just these checks
```bash
curl -s -X POST https://ora.ai/api/scan/checks -H 'content-type: application/json' -d '{"url":"https://example.com","checkIds":["markdown-negotiation-vary","markdown-negotiation"]}'
```
This calls the endpoint Ora documents for re-verifying a fix. It sends no cache, returns a result for each id and no total score, and spends one scan from the daily budget. Replace the URL with yours. [How to re-verify one fix](https://agentreadychecklist.com/guides/re-verify-one-fix-with-ora/).
### Or audit the whole site
```bash
npx ax@0.10 audit https://example.com --min-score 70
```
Exit code 1 means the score is below the number you passed, so the same line gates a deploy: [the CI recipe](https://agentreadychecklist.com/guides/gate-deploys-on-agent-readiness-in-ci/). [Why this site recommends Ora, and where it falls short](https://agentreadychecklist.com/verify-with-ora/).
## In the crawl
This row has one crawl rate. Each panel splits the 2026-11-04 crawl into ten bands of 1,000 ranks, on a 0 to 100 percent scale.
Accept: text/markdown returns text/markdown
3.4% overall
Reachable sites in the Tranco top 10,000 on which the check ran, 2026-11-04. Left is ranks 1 to 1,000.
Numbers behind the chart
| Rate | 1 to 1,000 | 1,001 to 2,000 | 2,001 to 3,000 | 3,001 to 4,000 | 4,001 to 5,000 | 5,001 to 6,000 | 6,001 to 7,000 | 7,001 to 8,000 | 8,001 to 9,000 | 9,001 to 10,000 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Accept: text/markdown returns text/markdown | 4% | 2% | 4% | 5% | 4% | 4% | 2% | 3% | 3% | 3% |
## Fix it on your platform
### Next.js (App Router)recipe
In proxy.ts check request.headers.get("accept")?.includes("text/markdown") and return NextResponse.rewrite(new URL(pathname + ".md", request.url)) to a Route Handler that serves the markdown twin.
Next.js 16.x (npm latest 16.4.5, read 2026-11-04); docs at nextjs.org/docs/app. Read 2026-11-04. [nextjs.org/docs/app/api-reference/file-conventions/proxy](https://nextjs.org/docs/app/api-reference/file-conventions/proxy). [All Next.js (App Router) recipes](https://agentreadychecklist.com/platforms/nextjs-app-router/#cf-markdown-negotiation)
### Astroworkaround
Static builds cannot vary by Accept on their own. Either switch the route to on-demand (export const prerender = false with an adapter) and rewrite in middleware when the Accept header contains text/markdown, or use host rules (Vercel has conditions, Cloudflare Markdown for Agents).
Astro 7.x (npm latest astro 7.4.5, @astrojs/sitemap 3.7.4, read 2026-11-04). Read 2026-11-04. [docs.astro.build/en/guides/on-demand-rendering/](https://docs.astro.build/en/guides/on-demand-rendering/). [All Astro recipes](https://agentreadychecklist.com/platforms/astro/#cf-markdown-negotiation)
### Nuxtrecipe
In server/middleware/markdown.ts read getRequestHeader(event, "accept"); when it includes text/markdown, return the markdown twin for the path with the correct content type.
Nuxt 4.x (npm latest nuxt 4.6.4, @nuxtjs/robots 7.0.2, @nuxtjs/sitemap 9.1.0, read 2026-11-04). Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server). [All Nuxt recipes](https://agentreadychecklist.com/platforms/nuxt/#cf-markdown-negotiation)
### SvelteKitrecipe
In src/hooks.server.ts handle: if (event.request.headers.get("accept")?.includes("text/markdown")) return new Response(markdownFor(event.url.pathname), { headers }); otherwise return resolve(event).
SvelteKit (npm latest @sveltejs/kit 3.1.1, read 2026-11-04); docs at svelte.dev/docs/kit. Read 2026-11-04. [svelte.dev/docs/kit/hooks](https://svelte.dev/docs/kit/hooks). [All SvelteKit recipes](https://agentreadychecklist.com/platforms/sveltekit/#cf-markdown-negotiation)
### Remix and React Router (framework mode)recipe
In server middleware check request.headers.get("accept") for text/markdown and return a markdown Response for the path; otherwise call next().
React Router framework mode (npm latest react-router 8.5.1; Remix v2 @remix-run/node 2.17.5, read 2026-11-04); docs at reactrouter.com. Read 2026-11-04. [reactrouter.com/how-to/middleware](https://reactrouter.com/how-to/middleware). [All Remix and React Router (framework mode) recipes](https://agentreadychecklist.com/platforms/remix-react-router/#cf-markdown-negotiation)
### Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)workaround
Vercel: a vercel.json rewrite with has \[{ type: "header", key: "accept", value: ".\*text/markdown.\*" }\] from "/(.\*)" to "/$1.md". Netlify: an Edge Function. Cloudflare Pages: a Pages Function, or enable Markdown for Agents on the zone. GitHub Pages: not possible (no request logic). S3 and CloudFront: a CloudFront Function on viewer request that rewrites the URI.
Host documentation as published on 2026-11-04 (no version numbers; config files \_headers, \_redirects, vercel.json, 404.html). Read 2026-11-04. [vercel.com/docs/project-configuration/vercel-json](https://vercel.com/docs/project-configuration/vercel-json). [All Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront) recipes](https://agentreadychecklist.com/platforms/static-hosting/#cf-markdown-negotiation)
### WordPress and Elementorworkaround
Core cannot negotiate. Enable Cloudflare Markdown for Agents on the zone, or use a plugin that answers `Accept: text/markdown` from a template\_redirect hook. Test: `curl -sI -H 'Accept: text/markdown' https://example.com/ | grep -i content-type`.
WordPress 7.1.4 (core release from the version-check API), Elementor 4.3.6 (plugin directory, updated 2026-11-02), Yoast SEO 28.8 noted for llms.txt; docs read 2026-11-04. Read 2026-11-04. [developer.wordpress.org/reference/hooks/send\_headers/](https://developer.wordpress.org/reference/hooks/send_headers/). [All WordPress and Elementor recipes](https://agentreadychecklist.com/platforms/wordpress-elementor/#cf-markdown-negotiation)
### Shopify (Online Store 2.0 themes)recipe
Platform behaviour, no setting: `curl -sI -H 'Accept: text/markdown' https://shop.example/ | grep -i content-type` should print text/markdown. Test a product and a collection URL too.
Hosted SaaS, Online Store 2.0 Liquid themes, docs read 2026-11-04; storefront behaviour probed live on one Shopify store the same day. Read 2026-11-04. [shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid](https://shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid). [All Shopify (Online Store 2.0 themes) recipes](https://agentreadychecklist.com/platforms/shopify/#cf-markdown-negotiation)
### Webflowrecipe
Enterprise on Webflow's Cloudflare hosting: Site settings > Publishing > Advanced publishing options > AI and Agents on, Save, publish. Other plans: workaround is a Cloudflare zone in front with Markdown for Agents.
Hosted SaaS, help center articles read 2026-11-04 (updated dates 2024-10-14 to 2026-10-29). Read 2026-11-04. [help.webflow.com/hc/en-us/articles/50435871026195-Markdown-for-AI-agents](https://help.webflow.com/hc/en-us/articles/50435871026195-Markdown-for-AI-agents). [All Webflow recipes](https://agentreadychecklist.com/platforms/webflow/#cf-markdown-negotiation)
### Framerrecipe
Built in, no setup: `curl -sI -H 'Accept: text/markdown' https://example.com/ | grep -i content-type` prints text/markdown.
Hosted SaaS, help articles read 2026-11-04 (marked updated 2026-09-15). Read 2026-11-04. [framer.com/help/articles/make-site-readable-by-ai-agents/](https://www.framer.com/help/articles/make-site-readable-by-ai-agents/). [All Framer recipes](https://agentreadychecklist.com/platforms/framer/#cf-markdown-negotiation)
### Wix (Wix Editor and Wix Studio)workaround
Not documented for Wix sites and not observed on www.wix.com (2026-11-04). Not possible on this platform; workaround: Wix Headless on your own host, or a Cloudflare zone with Markdown for Agents in front.
Hosted SaaS, help center read 2026-11-04. Read 2026-11-04. [dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support). [All Wix (Wix Editor and Wix Studio) recipes](https://agentreadychecklist.com/platforms/wix/#cf-markdown-negotiation)
### Squarespace (version 7.1)workaround
Not offered. Not possible on this platform; workaround: a Cloudflare zone with Markdown for Agents in front of the custom domain.
Hosted SaaS, version 7.1 sites, help center read 2026-11-04 (articles updated 2026-07-17 to 2026-11-03). Read 2026-11-04. [support.squarespace.com/hc/en-us/articles/206744067-How-does-Squarespace-optimize-my-site-for-search-results](https://support.squarespace.com/hc/en-us/articles/206744067-How-does-Squarespace-optimize-my-site-for-search-results). [All Squarespace (version 7.1) recipes](https://agentreadychecklist.com/platforms/squarespace/#cf-markdown-negotiation)
### HubSpot CMS (Content Hub)workaround
Not offered on HubSpot hosting. Not possible on this platform; workaround: a Cloudflare zone with Markdown for Agents in front of the domain.
Hosted SaaS, Content Hub, knowledge base and developer docs read 2026-11-04. Read 2026-11-04. [knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects](https://knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects). [All HubSpot CMS (Content Hub) recipes](https://agentreadychecklist.com/platforms/hubspot-cms/#cf-markdown-negotiation)
### Docusaurusworkaround
Docusaurus serves HTML for Accept: text/markdown. Put the site on a Cloudflare zone and enable Markdown for Agents, which converts HTML at the edge and returns text/markdown.
3.10.2 (npm @docusaurus/core latest, read 2026-11-04). Read 2026-11-04. [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/). [All Docusaurus recipes](https://agentreadychecklist.com/platforms/docusaurus/#cf-markdown-negotiation)
### Mintlifyrecipe
Automatic: curl -H 'Accept: text/markdown' https:/// returns text/markdown.
Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export). [All Mintlify recipes](https://agentreadychecklist.com/platforms/mintlify/#cf-markdown-negotiation)
### GitBookrecipe
Automatic: Accept: text/markdown returns the page as text/markdown (tested 2026-11-04 on gitbook.com/docs).
Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs). [All GitBook recipes](https://agentreadychecklist.com/platforms/gitbook/#cf-markdown-negotiation)
### ReadMerecipe
Turn on Markdown for Agents in AI > AI Discoverability; Accept: text/markdown then returns Markdown.
Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [docs.readme.com/main/docs/ai-discoverability](https://docs.readme.com/main/docs/ai-discoverability). [All ReadMe recipes](https://agentreadychecklist.com/platforms/readme/#cf-markdown-negotiation)
### Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround
Use Cloudflare Markdown for Agents or a Worker in front of the storefront; Salesforce documents no native negotiation.
Hosted SaaS (B2C Commerce help release 264.0.0); PWA Kit retail-react-app 10.3.0 and pwa-kit-runtime 3.21.0 on npm, read 2026-11-04. Read 2026-11-04. [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/). [All Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront) recipes](https://agentreadychecklist.com/platforms/salesforce-commerce-cloud/#cf-markdown-negotiation)
### Adobe Commerce and Magento Open Sourceworkaround
Put Cloudflare Markdown for Agents in front, or implement a Fastly VCL branch on Accept: text/markdown that routes to a converter.
2.4.9 (GitHub tag published 2026-05-12; 2.4.10-alpha1 tagged 2026-10-13); release notes read 2026-11-04. Read 2026-11-04. [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/). [All Adobe Commerce and Magento Open Source recipes](https://agentreadychecklist.com/platforms/adobe-commerce/#cf-markdown-negotiation)
## What it does not do
- Does not fix a page whose HTML lacks the answer.
- The closest AgentReady item, AR-READ-09, is about advertising a mirror, not negotiating.
## Common mistakes
- Returning markdown with Content-Type text/plain or text/html.
- Serving markdown to browsers that send \*/\*.
## Related
- Term: [MUST](https://agentreadychecklist.com/glossary/must/)
## Sources
- [isitagentready.com/.well-known/agent-skills/markdown-negotiation/SKILL.md](https://isitagentready.com/.well-known/agent-skills/markdown-negotiation/SKILL.md)read 2026-11-04
- [blog.cloudflare.com/agent-readiness/](https://blog.cloudflare.com/agent-readiness/)read 2026-11-04
- [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md)read 2026-11-04
- [nextjs.org/docs/app/api-reference/file-conventions/proxy](https://nextjs.org/docs/app/api-reference/file-conventions/proxy)read 2026-11-04
- [docs.astro.build/en/guides/on-demand-rendering/](https://docs.astro.build/en/guides/on-demand-rendering/)read 2026-11-04
- [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server)read 2026-11-04
- [svelte.dev/docs/kit/hooks](https://svelte.dev/docs/kit/hooks)read 2026-11-04
- [reactrouter.com/how-to/middleware](https://reactrouter.com/how-to/middleware)read 2026-11-04
- [vercel.com/docs/project-configuration/vercel-json](https://vercel.com/docs/project-configuration/vercel-json)read 2026-11-04
- [developer.wordpress.org/reference/hooks/send\_headers/](https://developer.wordpress.org/reference/hooks/send_headers/)read 2026-11-04
- [shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid](https://shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid)read 2026-11-04
- [help.webflow.com/hc/en-us/articles/50435871026195-Markdown-for-AI-agents](https://help.webflow.com/hc/en-us/articles/50435871026195-Markdown-for-AI-agents)read 2026-11-04
- [framer.com/help/articles/make-site-readable-by-ai-agents/](https://www.framer.com/help/articles/make-site-readable-by-ai-agents/)read 2026-11-04
- [dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support)read 2026-11-04
- [support.squarespace.com/hc/en-us/articles/206744067-How-does-Squarespace-optimize-my-site-for-search-results](https://support.squarespace.com/hc/en-us/articles/206744067-How-does-Squarespace-optimize-my-site-for-search-results)read 2026-11-04
- [knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects](https://knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects)read 2026-11-04
- [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/)read 2026-11-04
- [mintlify.com/docs/ai/markdown-export](https://mintlify.com/docs/ai/markdown-export)read 2026-11-04
- [gitbook.com/docs/getting-started/llm-ready-docs](https://gitbook.com/docs/getting-started/llm-ready-docs)read 2026-11-04
- [docs.readme.com/main/docs/ai-discoverability](https://docs.readme.com/main/docs/ai-discoverability)read 2026-11-04
- [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05
- [ora.ai/llms-full.txt](https://ora.ai/llms-full.txt?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05
- [registry.npmjs.org/ax, the ax README](https://registry.npmjs.org/ax)read 2026-11-05
Verify with Ora
The scanner this site recommends for the whole checklist. 132 checks, a score out of 100, no account.
`npx ax@0.10 audit --min-score `
[Why Ora, and its limits](https://agentreadychecklist.com/verify-with-ora/)
Fix it on
- [Next.js (App Router)recipe](#p-nextjs-app-router)
- [Astroworkaround](#p-astro)
- [Nuxtrecipe](#p-nuxt)
- [SvelteKitrecipe](#p-sveltekit)
- [Remix and React Router (framework mode)recipe](#p-remix-react-router)
- [Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)workaround](#p-static-hosting)
- [WordPress and Elementorworkaround](#p-wordpress-elementor)
- [Shopify (Online Store 2.0 themes)recipe](#p-shopify)
- [Webflowrecipe](#p-webflow)
- [Framerrecipe](#p-framer)
- [Wix (Wix Editor and Wix Studio)workaround](#p-wix)
- [Squarespace (version 7.1)workaround](#p-squarespace)
- [HubSpot CMS (Content Hub)workaround](#p-hubspot-cms)
- [Docusaurusworkaround](#p-docusaurus)
- [Mintlifyrecipe](#p-mintlify)
- [GitBookrecipe](#p-gitbook)
- [ReadMerecipe](#p-readme)
- [Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround](#p-salesforce-commerce-cloud)
- [Adobe Commerce and Magento Open Sourceworkaround](#p-adobe-commerce)
Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.