Cloudflare 开源了一个文档框架 Nimbus

简单分享一下 Cloudflare 最近发布的这个叫做 Nimbus 的开源文档框架。

之所以想分享这个内容，主要原因有两点。

一是这个文档框架特别适合用来做内容类型站点，类似上图这样的布局，左侧大分类右侧悬浮小目录，符合内容类型站点的基本要求。

二是我在 24 年用 AI 折腾过这类内容站点的搭建，想要的就是这么一种效果，但现在人家直接开源出来了，简单几个命令便可以拿过来使用，不得不感叹 Cloudflare 真的是互联网领域的赛博菩萨。

所以具体到应用场景上，我觉得两种场景特别适合。

比如你的网站现在想开辟一个技术指南板块，部署与产品相关的技术参数知识，那使用这个框架便再合适不过了。

比如你现在需要上线一个内容营销类型的站点，如果厌倦了传统建站的 WordPress 这款系统，不妨可以尝试下 Nimbus 这款文档框架。

此外使用这款框架还有一个额外的好处，就是能与 Cloudflare 提供的免费工具无缝衔接。

你在本地把网站创建好之后，并可以通过简单的几句命令把网站上线到 Cloudflare Worker 上，整个过程几乎不需要人工干预。

且如果整个网站的访问量不高的话（Cloudflare Worker 每天十万次的免费访问），基本是没有成本的。

聊完这款文档框架的优势，再来简单分享一下 Cloudflare 为什么要在现阶段要做这么一个文档框架，毕竟市面上已经有不少好用的文档框架了。

官方介绍里面是说，这款文档框架不是单纯“给人看的文档主题”，而是一套同时面向人类读者和 AI Agent 的、源码完全归项目所有的文档框架。

意思就是这款框架在开发设计之初，就开始把 AI Agent 当正式读者，并为之提供了一系列便利功能。

比如：干净的 Markdown 版本、面向源码理解的 MDX 版本、llms.txt 支持，以及其他的 SEO On-Page 支持。

这就使得像 Claude、Codex 这样的编码 Agent 不必从复杂 HTML 中提取正文，就能直接读取项目说明、API 文档和操作步骤。

此外，这款文档框架在真实用户体验这方面做得也非常不错。

整体的 URL 页面设计非常简洁大方，能符合绝大多数的项目要求（如果你有自定义的需求也可以更改源码来适配项目要求）。

另外这款框架提供了一个文档网站所需要的各种功能，像全文搜索、浅色/深色主题、无障碍导航、移动端侧边栏、版本化文档等等这些功能都是支持的。

我也是周末才发现这款文档框架的存在，并在本地随意搭建了一个测试项目来体验，总体的感觉是非常不错。

当然这款框架也在持续更新中，后续可能会有大版本迭代，到时候实际深度使用了再来分享点我自己的经验。