Skip to content

Add rule: Do you serve Markdown to AI agents? - #13168

Merged
isaaclombardssw merged 2 commits into
isaac/allow-ai-answer-enginesfrom
isaac/serve-markdown-to-ai-agents
Aug 18, 2026
Merged

Add rule: Do you serve Markdown to AI agents?#13168
isaaclombardssw merged 2 commits into
isaac/allow-ai-answer-enginesfrom
isaac/serve-markdown-to-ai-agents

Conversation

@isaaclombardssw

Copy link
Copy Markdown
Member
  1. What triggered this change? (PBI link, Email Subject, conversation + reason, etc)

✏️ Building the AI Search Readiness tool for tina.io. It checks whether a site serves Markdown to agents and had no SSW rule to link to. Pairs with #13167.

  1. What was changed?

✏️ New rule at /serve-markdown-to-ai-agents covering:

  • Content negotiation via Accept: text/markdown, with a request/response example. Cloudflare measured up to 80% fewer tokens than the HTML equivalent
  • Vary: Accept as mandatory, since without it a CDN can cache the Markdown response and serve plain text to real visitors
  • The .md URL fallback, because only Claude Code, OpenCode and Cursor send the header by default today
  • Why this is nearly free on a Markdown-backed site: the source Markdown already exists and is currently discarded at build time
  • How it differs from llms.txt, which is one index file rather than per-page delivery
  • A curl one-liner to check your own site

Added to Rules to Better Google Rankings and SEO, and cross-linked with the existing Do you optimize your content for AI answers? rule. No overlap: that rule covers how to write content, this one covers how to deliver it.

Sources cited in the rule: Cloudflare Markdown for agents, Cloudflare Agent Readiness score, RFC 9110.

Validators run locally and passing: frontmatter, check-mdx, category-sync, lint-urls.

  1. I paired or mob programmed with:

✏️ n/a

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

🔍 Preview PR Changes

View updated pages in edit mode:

Branch: isaac/serve-markdown-to-ai-agents

@github-actions github-actions Bot added the Age: 🥚 - New About 2 hours old label Aug 12, 2026
@isaaclombardssw
isaaclombardssw changed the base branch from main to isaac/aeo-geo-category August 12, 2026 23:48
@isaaclombardssw
isaaclombardssw force-pushed the isaac/serve-markdown-to-ai-agents branch from 3248098 to ced5146 Compare August 12, 2026 23:48
@isaaclombardssw
isaaclombardssw changed the base branch from isaac/aeo-geo-category to isaac/allow-ai-answer-engines August 13, 2026 01:53
@isaaclombardssw
isaaclombardssw force-pushed the isaac/serve-markdown-to-ai-agents branch from ced5146 to 6c2b21f Compare August 13, 2026 01:53
@isaaclombardssw
isaaclombardssw force-pushed the isaac/serve-markdown-to-ai-agents branch from 6c2b21f to c537475 Compare August 13, 2026 02:01
@github-actions github-actions Bot added Age: 🐣 - Young About 4 hours old Age: 🐥 - Adolescent About 8 hours old Age: 🐤 - Mature About 16 hours old Age: 🐓 - Old About 32 hours old and removed Age: 🥚 - New About 2 hours old Age: 🐣 - Young About 4 hours old Age: 🐥 - Adolescent About 8 hours old Age: 🐤 - Mature About 16 hours old labels Aug 13, 2026
Comment thread public/uploads/rules/serve-markdown-to-ai-agents/rule.mdx Outdated
Comment thread public/uploads/rules/serve-markdown-to-ai-agents/rule.mdx Outdated
@tiagov8
tiagov8 force-pushed the isaac/serve-markdown-to-ai-agents branch from c537475 to ebb6f70 Compare August 13, 2026 18:04
@isaaclombardssw
isaaclombardssw force-pushed the isaac/serve-markdown-to-ai-agents branch from ebb6f70 to f92817c Compare August 14, 2026 01:40
isaaclombardssw and others added 2 commits August 14, 2026 11:45
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@isaaclombardssw
isaaclombardssw force-pushed the isaac/serve-markdown-to-ai-agents branch from f92817c to bf5cd33 Compare August 14, 2026 01:46
@github-actions github-actions Bot added Age: 🍗 - Ancient About 64 hours old 🔥 Merge Debt This PR contains merge debt, see https://www.ssw.com.au/rules/merge-debt/ and removed Age: 🐓 - Old About 32 hours old labels Aug 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Howzit @isaaclombardssw,

This PR has been here a while.

Did you know you should avoid merge debt?

  1. Please action (e.g. get a review) and merge or close

Thanks!

@github-actions github-actions Bot added the Age: 🦖 - Extinct About 128 hours old label Aug 15, 2026
@github-actions github-actions Bot removed the Age: 🍗 - Ancient About 64 hours old label Aug 15, 2026
@isaaclombardssw
isaaclombardssw merged commit 494df50 into main Aug 18, 2026
8 checks passed
@isaaclombardssw
isaaclombardssw deleted the isaac/serve-markdown-to-ai-agents branch August 18, 2026 00:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Age: 🦖 - Extinct About 128 hours old 🔥 Merge Debt This PR contains merge debt, see https://www.ssw.com.au/rules/merge-debt/

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants