Site supports markdown content negotiation

medium

agent_content_markdown

Checks if the site supports Markdown for Agents content negotiation.

What does this rule check?

Markdown content negotiation allows AI agents to request a clean markdown version of your HTML pages by sending Accept: text/markdown. This provides structured, easy-to-parse content without HTML noise.

Why is this important?

AI agents process markdown far more efficiently than HTML. Markdown negotiation lets agents get clean, structured content without parsing complex DOM trees, improving the quality of AI interactions with your site.

How to fix

Enable Markdown for Agents so requests with Accept: text/markdown return a markdown version of your HTML response while HTML stays the default for browsers.

Examples

Incorrect 
GET / HTTP/1.1
Accept: text/markdown

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8

<!-- Returns HTML even when markdown was requested -->
Correct 
GET / HTTP/1.1
Accept: text/markdown

HTTP/1.1 200 OK
Content-Type: text/markdown

# My Site

Welcome to my site...

Agent fix snippet

Copy this snippet and paste it into your AI coding agent to fix this issue automatically.

Enable Markdown for Agents on your server or CDN.
For Cloudflare: enable it in your zone settings.
For custom servers: check the Accept header and return text/markdown content when requested.