个人博客与文档框架持续更新对比表

这是一份面向个人网站、博客、知识库和技术文档混合场景的持续更新资料。

它不试图给框架做绝对排名，而是帮助回答三个问题：

1. 这个工具属于开源框架、静态站生成器，还是托管平台？
2. 它最适合解决什么问题？
3. 在什么情况下，它不应该成为第一选择？

相关长文：

• 个人网站、博客与文档，为什么正在变成同一种产品？
• Fumadocs、Nextra、Rspress、Starlight：个人内容网站如何选型
• 品牌首页与文档博客如何共存：Orbit Studio 的 Fumadocs 架构实践

快速结论

Coding Agent 已经显著降低跨技术栈试用和实现的门槛。下表保留“技术中心”是为了说明组件生态、部署与后续维护边界，不建议把它当成第一轮筛选条件；第一轮仍应从内容形态、品牌自由度、发布方式和长期控制权出发。

核心定位

内容与网站能力

说明：

• “支持”不代表维护成本相同；
• “版本化”需要区分完整站点版本、部分目录版本和内容发布历史；
• Blog 能力需要继续核对标签、RSS、作者页和时间归档是否开箱可用。

搜索、AI 与平台能力

定制方式与维护代价

Fumadocs

Fumadocs 官方首页强调可定制的 React 文档框架，并直接展示品牌首页与文档阅读界面的组合。访问官网

定制路径：

• Layout props；
• Page Tree 和 Source；
• slots；
• 自定义 MDX 组件；
• CLI Customize 或 Headless 方式。

主要风险：灵活性高，容易在没有边界时复制框架内部组件。

Nextra

Nextra 官方首页把定位集中在 Next.js、MDX 和内容网站，并用实际文档页面展示 Docs Theme。访问官网

定制路径：

• Docs/Blog Theme 配置；
• Next.js 页面与组件；
• 自定义 CSS；
• Custom Theme。

主要风险：基础定制很直接，超出主题范式后可能跨入自行维护主题。

Rspress

Rspress 官方首页突出静态站生成、默认文档界面和“Made for humans. Understood by AI”的方向。访问官网

定制路径：

• CSS Variables；
• BEM Class；
• ESM 组件覆盖；
• rspress eject。

主要风险：Eject 后需要自己维护导出的组件与上游变化。

Starlight

Starlight 官方首页强调快速、可访问、易使用的完整文档体验，并明确建立在 Astro 之上。访问官网

定制路径：

• Astro 配置；
• CSS；
• 组件覆盖；
• Starlight Plugin；
• React、Vue、Svelte、Solid 等组件。

主要风险：对已有非 Astro 项目，迁移成本可能高于主题收益。

Docusaurus

Docusaurus 官方首页直接强调内容优先，并展示 MDX、React 和多语言等成熟能力。访问官网

定制路径：

• 配置；
• 插件；
• React 页面；
• Swizzle 和自定义主题。

主要风险：能力面广，小型项目容易引入不需要的复杂度。

VitePress

VitePress 官方首页清楚表达了 Vue、Vite、Markdown 和静态文档站的产品边界。访问官网

定制路径：

• Theme Config；
• 扩展默认主题；
• 自定义 Vue 主题；
• Vite 插件和构建时数据。

主要风险：技术中心明确属于 Vue，不应为了默认主题让 React 项目跨栈迁移。

Mintlify

Mintlify 官方首页当前把自己定位为 Agent 使用的知识基础设施，页面同时展示搜索、Assistant 与结构化文档体验。访问官网

定制路径：

• docs.json 与主题设置；
• MDX 组件；
• 自定义 CSS/JS；
• 更高级的自定义开发者门户和企业能力。

主要风险：平台能力、价格和开放范围需要随套餐持续核对。

官方案例与展示

选型时不要只看框架自己的文档站。优先从 Showcase 中各挑三个与自己相似的案例：

• Fumadocs Showcase：包含开发者工具文档和 Blog 案例；
• Nextra Showcase：包含大量 Next.js 生态项目；
• Starlight Showcase：包含文档、知识库和公共项目；
• Docusaurus Showcase：适合观察大型、多版本和品牌化文档；
• Mintlify Customers：适合判断商业托管平台的最终呈现和团队场景。

Rspress 当前优先查看：

• Rspress 官方站；
• Rspress 2.0 发布说明；
• 官方插件。

观察案例时，建议记录：

1. 首页是文档首页、品牌首页还是产品页；
2. 内容数量与层级；
3. 移动端导航；
4. 多语言与版本切换；
5. API、代码示例或交互组件；
6. 哪些效果来自框架默认，哪些显然是项目自定义。

选型验证模板

不要只比较官网。给每个最终候选做同一组最小验证：

[ ] 创建一个自定义首页
[ ] 导入一篇真实长文
[ ] 建立两层内容目录
[ ] 加入代码块、图片和复杂表格
[ ] 加入一个自定义组件
[ ] 建立中英文对应页面
[ ] 检查手机侧栏和目录
[ ] 运行生产构建
[ ] 记录需要覆盖或复制的组件
[ ] 估算一年内的升级与维护责任

建议把结果记录为：

更新记录

下次更新重点

• 核对各框架当前稳定版本和 Node.js 要求；
• 重新检查 Blog、RSS、搜索和多语言能力；
• 核对 Rspress 2 的 Showcase 与生态变化；
• 核对 Mintlify 套餐、AI credits 和自托管边界；
• 增加实际原型的构建时间与定制记录；
• 如果 Orbit Studio 更换内容框架，记录触发重新选型的条件。

官方资料

• Fumadocs Documentation
• Fumadocs Comparisons
• Nextra Documentation
• Rspress Documentation
• Starlight Documentation
• Docusaurus Documentation
• VitePress Documentation
• Mintlify Quickstart
• Mintlify Pricing