Fumadocs 16：为 React 和 Next.js 优化的精美文档框架

Fumadocs 16 官方网站 是一款面向开发者的文档框架，专注于为 React 和 Next.js 项目提供美观且优化的文档解决方案。

产品概览

Fumadocs 16 由 Fuma Nama 设计开发，是一个灵活、高性能的 React.js 文档框架，旨在帮助开发者快速构建优秀的文档站点。它通过提供高度可组合的模块化组件，解决了开发者每次启动新项目时都需要重复构建完整文档站点的痛点。

核心特性

精美设计与高度可定制性

Fumadocs 提供精心设计的主题，同时支持无头（headless）模式，允许开发者插入自己的 UI 组件。专业设计师可以使用 Fumadocs CLI 自定义主题：

pnpm dlx @fumadocs/cli customise
> Choose a layout to customise...

强大的内容编写体验

Fumadocs 原生支持 Markdown 和 MDX，为非开发者写作者、开发者和 AI 智能体提供直观、便捷且丰富的语法支持。支持的特性包括：

• Markdown 基础功能（包括图片）
• 语法高亮（基于 Shiki）
• 代码块分组
• 标注框（Callouts）
• 卡片（Cards）
• 自定义标题锚点
• 自动生成目录

MDX 扩展能力

开发者可以在内容中使用 JavaScript 和 JSX 语法：

• 自定义组件
• 内容包含/嵌入
• TypeScript Twoslash：在代码块中显示类型信息
• Shiki 标注
• 通过 remark、rehype 插件进行扩展

框架无关性

Fumadocs 官方支持 Next.js、Tanstack Start、React Router、Waku 等框架，并可以移植到任何 React.js 框架。其模块化架构分为：

• fumadocs-mdx：优雅地在 React 框架中使用 MDX
• fumadocs-core：构建文档和处理内容的无头库
• fumadocs-ui：构建文档的 UI 库
• fumadocs-openapi：扩展以渲染 OpenAPI 文档
• fumadocs-obsidian：处理 Obsidian 风格 Markdown

集成生态

内容源适配

Fumadocs 设计用于与任何内容源集成，支持 MDX、内容集合（Content Collections）和各类 CMS 系统，包括：

• BaseHub CMS
• Sanity
• Payload CMS

搜索增强

Fumadocs 可以轻松集成 Orama Search 和 Algolia Search，为文档提供强大的搜索体验。

开发者工具

快速启动

通过 CLI 工具快速初始化新项目：

pnpm create fumadocs-app

交互式组件

Fumadocs CLI 可以为文档创建交互式组件，为用户提供丰富的体验，被誉为"文档界的 shadcn/ui"。

社区与开源

Fumadocs 100% 由热情和开源社区驱动，拥有活跃的贡献者社区。项目在 GitHub 上完全开源，积极维护并欢迎贡献。

典型使用场景

1. 技术团队文档：为开源项目或企业内部工具创建专业的技术文档
2. API 文档：结合 OpenAPI 规范生成交互式 API 文档
3. 产品文档：为 SaaS 产品或开发者工具提供用户指南和帮助文档
4. 知识库建设：构建团队知识库和技术博客

上手建议

开发者可以通过以下途径开始使用 Fumadocs：

• 访问官方文档 学习使用方法
• 在 CodeSandbox 上体验在线示例
• 查看展示案例 获取灵感
• 参与 GitHub 项目 贡献代码

Fumadocs 16 以其精美的设计、强大的扩展能力和框架无关性，为 React 开发者提供了构建高质量文档的全新选择。