Learn
Accept Markdown, from protocol to production
Practical lessons on content negotiation, cache correctness, and the HTTP details that keep Markdown negotiation reliable.
What Accept Markdown Means
A practical explanation of serving Markdown from the same URL when clients send Accept: text/markdown.
Why AI Agents Prefer Markdown
Markdown gives agents a smaller, cleaner, higher-signal version of the content already present in your HTML.
Why Vary: Accept Is Required
Use Vary: Accept so caches do not mix HTML and Markdown responses for the same URL.
Accept Headers and Quality Values
Understand how clients express Markdown preference with Accept headers and q-values.
When to Return 406 Not Acceptable
Return 406 only when a client asks for representations your server truly cannot provide.