为什么选择 Fumadocs 搭建博客
记录我们选择 Fumadocs 作为博客框架的原因和使用体验。
背景
在搭建 Panfex 博客系统时,我们对比了多个方案:
| 方案 | 优点 | 缺点 |
|---|---|---|
| WordPress | 生态丰富,插件多 | 需要 PHP 环境,维护成本高 |
| Hexo / Hugo | 静态生成,速度快 | 与 Next.js 技术栈不统一 |
| Fumadocs | 原生 Next.js,MDX 支持 | 需要 Node.js 22+ |
为什么选择 Fumadocs
- 技术栈一致 — 我们的主站已经使用 Next.js,Fumadocs 完美兼容
- MDX 支持 — 不仅支持 Markdown,还能在文章中使用 React 组件
- 内置搜索 — 基于 Orama 的全文搜索,开箱即用
- 零数据库 — 文章就是文件,Git 管理版本,简单可靠
工作流
我们的文章发布流程非常简洁:
编写 .mdx 文件 → 放入 content/docs/ → 构建部署 → 自动上线没有后台管理界面,没有数据库,没有复杂的 CMS。文件即内容,Git 即版本管理。
小结
如果你也在使用 Next.js,并且需要一个轻量级的博客/文档系统,Fumadocs 是一个非常好的选择。