Skip to content
Back to Templates

Markdown to agents, HTML to humans

Demo project for delivering markdown to agents and HTML to humans.

Markdown for Agents Demo Thumbnail

Delivering Markdown to Agents, HTML to Humans

This demo project shows how to serve different formats of the same documentation depending on the client. AI agents benefit from receiving lightweight Markdown instead of full HTML, while browsers still get standard HTML for human readers.

By serving Markdown directly, we cut down token usage for AI agents, making it more efficient for them to parse and process documentation.

Demo

Compare

curl -H "Accept: text/markdown" https://markdown-to-agents.vercel.app/docs/getting-started

and

curl -H "Accept: text/html" https://markdown-to-agents.vercel.app/docs/getting-started

How it works

The rewrite in next.config.ts directs traffic asking for text/markdown to a route that returns markdown.

const nextConfig: NextConfig = {
rewrites: async () => {
return {
beforeFiles: [
{
source: "/docs/:slug",
destination: "/markdown/:slug",
has: [
{
type: "header",
key: "accept",
value: "(.*)text/markdown(.*)",
},
],
},
],
};
},
};