From 41962e6bf5f8bf12cfc1291c9e2df9266bde2ec5 Mon Sep 17 00:00:00 2001
From: Jeremias Menichelli <jmenichelli@gmail.com>
Date: Fri, 13 Mar 2026 13:32:40 +0100
Subject: [PATCH] feat(Docs): Implement Accept header for agents markdown
 requests (#43745)

---
 apps/docs/middleware.ts | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/apps/docs/middleware.ts b/apps/docs/middleware.ts
index 27868037dee..34cf26138b5 100644
--- a/apps/docs/middleware.ts
+++ b/apps/docs/middleware.ts
@@ -11,9 +11,12 @@ const GUIDES_PATH = `${BASE_PATH ?? ''}/guides`
 export function middleware(request: NextRequest) {
   const url = new URL(request.url)
 
+  const requestsMarkdown =
+    request.headers.get('Accept')?.includes('text/markdown') || url.pathname.endsWith('.md')
+
   // Serve pre-generated .md files before the [[...slug]] page route can intercept them
-  if (url.pathname.startsWith(GUIDES_PATH + '/') && url.pathname.endsWith('.md')) {
-    const slug = url.pathname.slice(GUIDES_PATH.length + 1, -'.md'.length)
+  if (url.pathname.startsWith(GUIDES_PATH + '/') && requestsMarkdown) {
+    const slug = url.pathname.replace(`${GUIDES_PATH}/`, '').replace(/\.md$/, '')
     const rewriteUrl = new URL(url)
     rewriteUrl.pathname = `${BASE_PATH ?? ''}/api/guides-md/${slug}`
     return NextResponse.rewrite(rewriteUrl)