Content negotiation: serve LLM-optimized `.md` docs when agents request `Accept: text/markdown` #8969

RaphaelGimenez · 2026-06-12T12:46:09Z

RaphaelGimenez
Jun 12, 2026

Summary

Mantine already generates LLM-optimized docs at /llms/{page}.md. But agents need to know about the /llms/ prefix. Content negotiation would let agents get markdown from the same URL they'd use in a browser — just by sending Accept: text/markdown.

Problem

Today, when an agent (Cursor, Claude, ChatGPT, etc.) fetches a Mantine docs page, it gets the full HTML — navigation, sidebar, footer, JS bundles (~500KB+). This wastes context tokens and makes answers less accurate. The agent has to explicitly know about /llms.txt or /llms/{page}.md paths.

With content negotiation, an agent can simply curl https://mantine.dev/core/button -H "accept: text/markdown" and get back the clean .md version automatically — no site-specific knowledge needed.

Proposed implementation

1. Next.js rewrite for Accept: text/markdown

In next.config.ts, add a rewrite that detects the Accept header and routes to the existing /llms/ endpoint:

async rewrites() {
  return {
    beforeFiles: [
      {
        source: '/:path*',
        has: [{ type: 'header', key: 'accept', value: '(.*)text/markdown(.*)' }],
        destination: '/llms/:path*.md',
      },
    ],
  };
},

Since Mantine's .md files already exist at /llms/{section}-{page}.md, the mapping from docs URLs (e.g., /core/button) to /llms/core-button.md is straightforward.

2. Add <link rel="alternate"> for agent discovery

For agents that don't send Accept: text/markdown, add a discovery link in the HTML <head>:

<link rel="alternate" type="text/markdown" title="LLM-friendly version" href="/llms.txt" />

(Plus per-page variants pointing to /llms/{page}.md)

Prior art

Vercel implemented this for their blog and changelog: vercel.com/blog/making-agent-friendly-pages-with-content-negotiation
Cognition (Devin docs) uses the same pattern
The results are significant: Vercel's blog pages go from ~500KB HTML → ~3KB markdown (99% reduction)

What already exists (just needs wiring)

/llms/{page}.md — per-page LLM docs already generated on every release
/llms.txt — index of all LLM doc pages
/llms-full.txt — single consolidated file

I'm willing to submit a PR

Happy to implement this. The change is small and contained to the next.config.ts rewrites + potentially a <link> tag in the layout.

Navigation Menu

Mantine

Content negotiation: serve LLM-optimized `.md` docs when agents request `Accept: text/markdown` #8969

Uh oh!

{{title}}

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

Mantine

Content negotiation: serve LLM-optimized .md docs when agents request Accept: text/markdown #8969

Uh oh!

RaphaelGimenez Jun 12, 2026

Summary

Problem

Proposed implementation

Prior art

What already exists (just needs wiring)

I'm willing to submit a PR

Replies: 0 comments

Content negotiation: serve LLM-optimized `.md` docs when agents request `Accept: text/markdown` #8969

RaphaelGimenez
Jun 12, 2026