# Fix: Accept text/markdown content negotiation returns markdown

> Web-audit fix skill for the `accept-markdown` check (Content for agents, SHOULD).

## Goal

Honor Accept text/markdown on content URLs with raw markdown, not HTML chrome.

## Fix

Honor `Accept: text/markdown` on content URLs and return raw markdown rather than HTML chrome.
Agents parse markdown far more reliably than a JS-rendered page. Serve the markdown twin at the
same URL via content negotiation, invisibly to crawlers.

## Resources

- [RFC 7763 (text/markdown)](https://www.rfc-editor.org/rfc/rfc7763)

## Copy-paste prompt

Paste this into your coding agent, replacing the Issue line with the Result line from [your audit](https://anc.dev/web-audit):

```text
Goal: Honor Accept text/markdown on content URLs with raw markdown, not HTML chrome
Issue: <the audit's finding for this check>
Fix: Honor `Accept: text/markdown` on content URLs and return raw markdown rather than HTML chrome. Agents parse markdown far more reliably than a JS-rendered page. Serve the markdown twin at the same URL via content negotiation, invisibly to crawlers.
Skill: https://anc.dev/web-audit/skill/accept-markdown
Docs: https://www.rfc-editor.org/rfc/rfc7763
```

## Verify

Re-run the audit at [https://anc.dev/web-audit](https://anc.dev/web-audit) or call the `audit_website` MCP tool; the `accept-markdown` check should report `pass`.