Written by

Fuma Nama

At

Fri Dec 05 2025

Fumadocs MDX的未来

Fumadocs MDX 的路线图。

Back

Fumadocs MDX 概览

🌐 Overview of Fumadocs MDX

Fumadocs MDX 作为内容处理层，最初用于处理 MDX 文件，并作为 Contentlayer 的替代方案。

🌐 Fumadocs MDX serves as a content processing layer, initially developed for processing MDX files and as an alternative to Contentlayer.

它的主要功能包括：

🌐 Its primary functions include:

  • 编译和处理内容。
  • 提供访问已编译内容的接口。
  • 确保类型安全性以及在不同环境（例如浏览器和 Cloudflare Workers）中的兼容性。

与 CMS 的比较

🌐 Comparison with CMS

Fumadocs MDX 不是内容管理系统（CMS）。CMS 不仅仅包括内容处理，还集成了以下功能：

🌐 Fumadocs MDX is not a content management system (CMS). A CMS encompasses more than content processing, it integrates features such as:

  • **数据库集成：**用于存储内容。
  • 版本控制： 以启用回滚、提交和冲突解决。
  • 权限管理: 用于处理用户访问权限和角色。
  • 创作工作流程： 支持起草、审阅和发布等阶段。

Fumadocs MDX 本身缺乏这些 CMS 功能，但可以通过与 Git 和 GitHub 的集成来实现。这种方法相比传统 CMS 解决方案具有明显的优势，包括：

🌐 Fumadocs MDX lacks these CMS capabilities independently, but they can be achieved through integration with Git and GitHub. This approach offers distinct benefits over traditional CMS solutions, including:

  • 在 Git 中保持统一的历史记录，而不是将其分散到 Git 和单独的 CMS 中。
  • 在一个拉取请求中编写内容和代码更改。

GitHub 的协作工具，例如访问控制、拉取请求审核和自动化，支持创作工作流的实现。

🌐 GitHub's collaboration tools, such as access controls, pull request reviews, and automation, support the implementation of authoring workflows.

Fumadocs MDX 并不打算发展成内容管理系统；它仍然是一个基础的内容处理层。

🌐 Fumadocs MDX is not intended to evolve into a CMS; it remains a foundational content processing layer.

路线图

🌐 Roadmap

Fumadocs MDX 与 Fumadocs 密切相关，但内容处理层最好能够独立运作，而不依赖任何特定的文档框架。

🌐 Fumadocs MDX is closely associated with Fumadocs, yet the content processing layer should ideally operate independently, without reliance on any specific documentation framework.

注意

目前，Fumadocs MDX 完全依赖于 fumadocs-core 的 remark 和 rehype 插件。

在不久的将来，某些组件将过渡到 fuma-content，以提高可扩展性并引入更多 API。例如：

🌐 In the near future, certain components will transition to fuma-content, improving extensibility and introducing more APIs. Such as:

  • 框架无关： Fuma 内容应能在任何环境中运行，包括 Vite、Turbopack/Webpack，甚至 JS 运行时。
  • 无框架默认值： Fumadocs 的 MDX 预设将由 fumadocs-core 提供，可能作为 Fuma 内容插件。
  • 内容适配器： 扩展对 MDX 和 JSON 文件的支持，包括自定义集合类型，以及用于处理编辑器特定语法的 Obsidian 插件。
  • **Fumadocs MDX 无破坏性更改：**我们在底层采用 Fuma Content，但外部 API 不会改变。理想情况下，它将类似于 Vite 利用 Rollup 的方式。

在 API 方面，Fuma 内容插件将有别于打包器插件，但插件可以利用内置的抽象层来实现加载器。否则，我们将推荐在高级需求上使用 Unplugin 。

🌐 API-wise, Fuma Content plugins will distinguish from bundler plugins, but plugins can leverage the built-in abstraction layer to implement loaders. Otherwise, we will encourage Unplugin for advanced needs.

虽然 fuma-content 侧重于内容处理，但它为开发 CMS 层提供了基础，例如用于 MDX 编辑或远程数据库的插件。这将是一个更大的目标。

🌐 Although fuma-content focuses on content processing, it provides a foundation for developing a CMS layer, such as plugins for MDX editing or remote databases. It will be a bigger goal.

澄清

Fumadocs MDX 不仅仅是一个简单的 MDX 加载器，它的架构支持多种格式。

🌐 Fumadocs MDX extends beyond a simple MDX loader, its architecture supports multiple formats.

虽然目前没有计划更名，但“Fumadocs MDX”这个名称已经无法完全涵盖其范围。

🌐 Although no renaming is planned, the name Fumadocs MDX no longer fully captures its scope.

当前进展

🌐 The Current Progress

Fumadocs MDX 已经包含用于高级设置的基础功能，例如新的 Workspace API，它可以实现跨多个仓库的内容处理。

🌐 Fumadocs MDX already includes primitives for advanced setups, such as the new Workspace API, which enables content processing across multiple repositories.

我们欢迎大家在 GitHub Discussions 上提供反馈！

🌐 We are welcome for feedbacks on GitHub Discussions!