Markdown for Agents

What it is

AI agents parse Markdown far more reliably than HTML: explicit structure means better results and less token waste. On real sites, the HTML-to-Markdown difference is an order of magnitude — Cloudflare's own example shows ~725 tokens for the Markdown version of a page whose HTML carried ~12,345 tokens. This skill makes every page you build ship a clean Markdown version agents can read cheaply and correctly.

Core principle: structure is the feature. A Markdown version saves tokens only if it is clean — real heading hierarchy, prose stripped of nav/footer/scripts, frontmatter metadata, and preserved JSON-LD. A dump of raw HTML wrapped in backticks saves nothing.

When to use

Activate this skill when any of the following is true:

• You are building, launching, or redesigning a website, landing page, or docs site.
• The site may be consumed by AI agents, LLM crawlers, or AI search tools.
• The user wants to reduce token costs for AI systems reading their content.
• The user mentions "Markdown for Agents", "llms.txt", "AI crawlers", "AI-ready site", or "let agents read my site efficiently".
• A page already exists but has no meta tags, no JSON-LD, or no Markdown-accessible version.

Do NOT activate this skill for general SEO keyword work, visual design, or pure frontend build tasks with no public content.