.md 扩展

Geistdocs 包含一个内置功能，允许 AI 工具和语言模型以纯 Markdown 的形式访问你的文档。只需在任何文档页面的 URL 后追加 .mdx，即可获取处理后的 Markdown 内容。

工作原理

当你在任何文档 URL 后添加 .md 或 .mdx 时，你将得到页面内容的纯文本 Markdown，而不是呈现的 HTML。这样可以方便 AI 工具读取并理解你的文档。

示例

# Normal page
https://yourdomain.com/docs/getting-started

# Markdown version
https://yourdomain.com/docs/getting-started.mdx

.mdx 版本返回：

• 页面标题作为 H1 级标题
• 完整的处理后 Markdown 内容
• 无 HTML、样式或导航

使用场景

此功能特别适用于：

• AI 聊天工具 - 像 ChatGPT、Claude 和 Cursor 这样的工具可以获取并读取你的文档
• LLM 上下文 - 为语言模型提示提供干净的文本
• 文档分析 - 提取内容以便处理或分析
• 内容迁移 - 以干净的格式导出文档

实现

该功能使用 Next.js 的重写规则，将 .mdx 请求路由到一个特殊端点：

next.config.ts

async rewrites() {
  return [
    {
      source: "/docs/:path*.mdx",
      destination: "/llms.mdx/:path*",
    },
  ];
}

该端点会处理页面并以 text/markdown 内容类型返回纯 Markdown。

响应格式

响应包含：

• Content-Type: text/markdown
• 页面标题作为一级标题
• 来自 Fumadocs 的处理后 Markdown 内容

所有 MDX 组件都会被处理并转换为等效的纯 Markdown。