Cloudflare Markdown for Agents
In short
Cloudflare Markdown for Agents is a zone setting on the Cloudflare network that converts origin HTML to markdown on the fly when a client asks for text/markdown, adding YAML frontmatter, a token count header and a default Content-Signal header. Cloudflare announced Markdown for Agents on 12 February 2026 in its developer changelog5.
At a glance
- Type
- Markdown tooling
- Operator
- Cloudflare
- Pricing
- included for 1 of 3 products; no published price for the other 2
- Relation to Ora
- Ora's check catalog (contract 1.38.0, read 2026-11-05) has markdown-negotiation and markdown-negotiation-vary checks that a zone with this setting on can pass; Ora does not convert pages itself.
- Last read
- 2026-11-05
What it does for agent readiness
- Cloudflare Markdown for Agents is available in beta at no cost on the Pro, Business and Enterprise plans and for SSL for SaaS customers.1
- Cloudflare Markdown for Agents is switched on per zone in the AI Crawl Control section of the dashboard, through a Configuration Rule for chosen subdomains or paths, or by a PATCH to the zone setting content_converter.1
- Cloudflare Markdown for Agents converts at most 6 MiB (6,291,456 bytes) of decompressed HTML per response and converts HTML only.1
- Cloudflare Markdown for Agents keeps origin headers such as HSTS, CSP, Set-Cookie, CORS and Cache-Control, but drops Content-Length, ETag and Last-Modified because the converted body is streamed.1
- Cloudflare Markdown for Agents adds Content-Signal: ai-train=yes, search=yes, ai-input=yes when the origin sends no content-signal header, and keeps the origin value when one is set.1
- Cloudflare Markdown for Agents builds YAML frontmatter from the page meta title, description and og:image tags, and appends any JSON-LD blocks at the end in one fenced json code block.1
- Cloudflare sends an x-markdown-tokens header with each converted response giving the estimated token count of the markdown document.2
- Cloudflare measured its own launch post at 16,180 tokens in HTML and 3,150 tokens as markdown, which it called an 80 percent reduction.2
- Cloudflare wrote at launch that Claude Code and OpenCode already send Accept headers asking for markdown.2
- Cloudflare points sites that cannot use the setting to two other converters, the Workers AI AI.toMarkdown() call and the Browser Run /markdown endpoint for pages that need a real browser.1
Products and plans
| Product | What it does | Price | As of | Note |
|---|---|---|---|---|
| Markdown for Agents | Edge HTML to markdown conversion on content negotiation for a Cloudflare zone. | included, from 0 USD 1 | 2026-11-05 | No extra cost on Pro, Business and Enterprise plans and SSL for SaaS; beta. |
| Workers AI toMarkdown | Developer call that converts several document types to markdown, with summarisation. | no published price | ||
| Browser Run /markdown | Renders a dynamic page in a real browser before converting it to markdown. | no published price |
Standards
| Standard | Status | Evidence |
|---|---|---|
| Content Signals | Supports | Adds a default Content-Signal header to converted responses and keeps an origin value when one is set. 1 |
| llms.txt | No statement | The Markdown for Agents docs do not mention llms.txt. |
Our checks
| Check | Domain | Result | Measured on | Method |
|---|---|---|---|---|
| Ora score (cached) | cloudflare.com | 82, grade B | 2026-11-05 | GET https://ora.ai/api/score/cloudflare.com (cached result, no scan triggered); measured_on is Ora's stored scannedAt 3 |
| Cloudflare isitagentready scan | cloudflare.com | 53 percent, 8 of 15 checks, L4 Agent-Integrated | 2026-11-05 | POST https://isitagentready.com/api/scan with the default All Checks profile (every check except a2aAgentCard and ap2), one request every 3 seconds; percent = passed / counted over the four scored categories, as the page shows it 4 |
What it does not do
- Cloudflare Markdown for Agents does not convert PDFs or other non-HTML documents.
- Cloudflare Markdown for Agents is not listed for the Free plan; the docs name Pro, Business, Enterprise and SSL for SaaS.
- Cloudflare Markdown for Agents does not answer conditional requests on converted responses, because ETag and Last-Modified are removed.
Sources
- Cloudflare docs: Markdown for Agents (last updated 2026-10-09). https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/, read 2026-11-05.
- Cloudflare blog: Introducing Markdown for Agents (2026-02-12). https://blog.cloudflare.com/markdown-for-agents/, read 2026-11-05.
- Ora cached score for cloudflare.com. https://ora.ai/api/score/cloudflare.com, read 2026-11-05.
- isitagentready.com home page. https://isitagentready.com/, read 2026-11-05.
- Cloudflare changelog: Introducing Markdown for Agents (2026-02-12). https://developers.cloudflare.com/changelog/post/2026-02-12-markdown-for-agents/, read 2026-11-05.
Last reviewed 2026-11-05