Negotiation

Overview

For React.js frameworks supporting middlewares, you can use the Negotiation API of Fumadocs for basic functionalities.

It is a tiny wrapper of negotiator.

Accept Markdown

Serve markdown or HTML depending on the Accept header, this can improve the experience for AI agents.

middleware.ts (Next.js)

import { NextRequest, NextResponse } from 'next/server';
import { isMarkdownPreferred, rewritePath } from 'fumadocs-core/negotiation';

const { rewrite: rewriteLLM } = rewritePath('/docs/*path', '/llms.mdx/*path');

export function middleware(request: NextRequest) {
  if (isMarkdownPreferred(request)) {
    const result = rewriteLLM(request.nextUrl.pathname);

    if (result) {
      return NextResponse.rewrite(new URL(result, request.nextUrl));
    }
  }

  return NextResponse.next();
}

Overview

Accept Markdown

On this page