[WIP] Markdown for Agents documentation

[celso]

Summary

Adds Markdown for Agents documentation

Documentation checklist

• Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
• The change adheres to the documentation style guide.
• If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
• Files which have changed name or location have been allocated redirects.

[github-actions]

Preview URL: https://693f37c6.preview.developers.cloudflare.com
Preview Branch URL: https://celso-markdown-for-agents.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/	https://celso-markdown-for-agents.preview.developers.cloudflare.com/fundamentals/reference/markdown-for-agents/
https://developers.cloudflare.com/changelog/2026-02-12-markdown-for-agents/	https://celso-markdown-for-agents.preview.developers.cloudflare.com/changelog/2026-02-12-markdown-for-agents/
https://developers.cloudflare.com/browser-rendering/rest-api/markdown-endpoint/	https://celso-markdown-for-agents.preview.developers.cloudflare.com/browser-rendering/rest-api/markdown-endpoint/
https://developers.cloudflare.com/workers-ai/features/markdown-conversion/	https://celso-markdown-for-agents.preview.developers.cloudflare.com/workers-ai/features/markdown-conversion/

[threepointone]

blocking while we discuss

[elithrar]

/bonk review this PR and resolve merge conflicts

[ask-bonk]

PR Review: Markdown for Agents documentation

Merge Conflicts

Resolved 3 merge conflicts:

• model-context-protocol/index.mdx: Kept PR's sidebar reordering (order: 5 + group.hideIndex) to accommodate the new page at order 4.
• model-context-protocol/mcp-agent-api.mdx: Applied PR's order: 7 sidebar change while preserving production's richer content (elicitation, serve(), data jurisdiction, etc. that were added since this branch diverged).
• x402.mdx: Kept PR's sidebar reordering (order: 6 + group.hideIndex).

---

Issues Found

Important (should fix before merge)

1. Unused imports (markdown-for-agents.mdx:12-18): MetaInfo, Type, and WranglerConfig are imported but never used. Only Render and TypeScriptExample are actually used.

2. List numbering error (partials/agents/markdown-for-agents.mdx:13): Steps 2 and 3 are both numbered 2.:

   2. Select the zone you want to configure.
   2. Look for **Quick Actions**.  ← should be 3.
   

3. API path mismatch (partials/agents/markdown-for-agents.mdx:18): The prose says /api/v4/zones/{zone_tag}/settings/content_converter but the curl example correctly uses https://api.cloudflare.com/client/v4/.... The correct base path is /client/v4/, not /api/v4/.

Minor nits

4. Availability sentence (markdown-for-agents.mdx:81): "available to Pro and Business plans and SSL for SaaS customers" reads ambiguously. Consider: "available at no cost to Pro plans, Business plans, and SSL for SaaS customers."

5. Absolute vs relative links (markdown-for-agents.mdx:87-88): Links to Workers AI and Browser Rendering use absolute URLs (https://developers.cloudflare.com/...) — relative paths (/workers-ai/...) are preferred for internal links.

6. Hyphenation (markdown-for-agents.mdx:94): "zone level setting" → "zone-level setting" (compound adjective).

7. Parenthetical punctuation (partials/agents/markdown-for-agents.mdx:11): Period should be outside the parenthesis: "(you need a Pro or Business plan)." not "(you need a Pro or Business plan.)"

8. Vague dashboard instructions (partials/agents/markdown-for-agents.mdx:13-14): "Look for Quick Actions" doesn't specify where in the dashboard. Other Cloudflare docs typically specify the navigation path.

---

Note

This PR has a blocking review from @threepointone. The merge conflict resolution and any fixes should be staged, but the PR should not merge until that discussion is resolved.

[ask-bonk]

Here's a summary of what I did:

Merge Conflicts Resolved

3 real conflicts found and resolved (all in sidebar ordering due to the new "Markdown for Agents" page insertion at order 4):

File	Resolution
model-context-protocol/index.mdx	Kept PR's order: 5 + group.hideIndex: false
model-context-protocol/mcp-agent-api.mdx	Applied PR's order: 7 but kept production's richer content (elicitation, serve(), data jurisdiction sections)
x402.mdx	Kept PR's order: 6 + group.hideIndex: false

PR Review Summary

Found 3 important issues and 5 minor nits:

Important:

1. Unused imports (MetaInfo, Type, WranglerConfig) in the main page
2. Duplicate list numbering (two step 2.s) in the partial
3. API path mismatch: prose says /api/v4/ but should be /client/v4/

Note: The PR has a blocking review from @threepointone ("blocking while we discuss"), so it shouldn't merge until that's resolved regardless.

github run

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/changelog/	@cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/browser-rendering/	@mchenco, @cloudflare/pcx-technical-writing, @celso, @kathayl, @ToriLindsay
/src/content/docs/fundamentals/	@dcpena, @cloudflare/pcx-technical-writing
/src/content/docs/workers-ai/	@rita3ko, @craigsdennis, @mchenco, @cloudflare/pcx-technical-writing
*	@cloudflare/pcx-technical-writing

[elithrar]

/bonk address the review issues for Celso and thank him in Portuguese