.md 扩展

Geistdocs 允许 AI 工具和语言模型以纯 Markdown 的形式访问文档页面。在文档 URL 后追加 .md 或 .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 上下文 - 为语言模型提示提供干净的文本
• 文档分析 - 提取内容以便处理或分析
• 内容迁移 - 以干净的格式导出文档

实现

包内 proxy 会将 .md 和 .mdx 请求路由到返回 Markdown 的 route handler：

const proxy = createProxy({
  config: geistdocsConfig,
  markdownRoutes: [
    { from: "/docs/*path", to: "/[lang]/llms.mdx/*path" },
  ],
});

目标 route 使用 createDocsMarkdownRoute 处理页面，并以 text/markdown 内容类型返回 Markdown。

响应格式

响应包含：

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

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