Bangle.io：本地优先的 Markdown 笔记应用，但 WYSIWYG 的代价是什么
仅限网络的所见即所得笔记应用程序，以 Markdown 格式在本地保存笔记。 v2：。
秒懂
- 它是什么？
- Bangle.io 是一个纯网页端的笔记应用，把笔记存成 Markdown 文件，却用富文本编辑器来写。它适合不想被云服务锁定的用户，但你要接受浏览器环境的限制和 AGPL 许可证的约束。
- 适合谁用？
- Bangle.io 适合那些已经习惯 Markdown 文件管理、希望笔记完全留在本地、并且愿意用浏览器作为唯一编辑环境的用户。它不适合需要离线桌面应用、需要插件生态成熟稳定、或者对 AGPL 许可证有顾虑的团队。
- 能商用吗？
- 可以，但条件严格。AGPL-3.0 是网络 copyleft 许可证：如果别人通过网络使用你修改过的版本（例如作为托管服务），你必须以同一许可证向他们提供源代码。
- 还在维护吗？
- 在维护。仓库最近一次提交在 5 天前。
- 用什么语言写的？
- 主要是 TypeScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决什么问题：本地 Markdown 与 WYSIWYG 的矛盾
大多数笔记应用要么像 Notion 一样把数据存在云端，要么像 VS Code 插件一样只给你一个纯文本编辑器。Bangle.io 想同时给你两样东西：笔记以 Markdown 文件的形式保存在你自己的电脑上，编辑时却看到的是富文本格式。这个组合并不常见。Markdown 本身是纯文本，但 Bangle 用 WYSIWYG 编辑器把标题、加粗、列表渲染成所见即所得的样子。它的目标用户是那些不想被云服务绑定、又受不了纯文本编辑体验的人。
工作机制：浏览器里的文件系统与编辑器
Bangle.io 没有 Electron，它只是一个网页应用。这意味着它需要浏览器提供对本地文件系统的访问能力，通常是 File System Access API。用户打开一个文件夹，Bangle 读取里面的 Markdown 文件，编辑后写回。编辑器部分来自它的姊妹项目 bangle.dev，这是一个基于 ProseMirror 的编辑器框架。README 里说 bangle.dev 让 Bangle 能构建像 Notion 或 Dropbox Paper 那样强大的编辑器，还支持实时协作。但要注意，协作功能在 README 里只是提到，并没有说明当前是否可用。数据流大致是：文件系统读取 Markdown，编辑器把它解析成文档模型，用户编辑后序列化回 Markdown 格式。这个过程看似简单，但 Markdown 和富文本之间的转换是很多 bug 的源头。
启动与开发：pnpm 命令与端口脚本
要跑起开发实例，README 给出了两条命令：`pnpm install` 安装依赖，`pnpm start` 启动开发服务器，地址是 `localhost:5173`。项目使用 pnpm 作为包管理器，这点在命令里很清楚。如果你同时开多个工作树，项目提供了一个脚本 `node scripts/dev-ports.js --env`，用 `eval "$(node scripts/dev-ports.js --env)"` 执行，给 dev、preview、Storybook 和 Playwright 服务器分配固定的端口。这个脚本存在说明项目在开发环境上花了不少心思，但也暗示了它依赖多个并行服务。普通用户不需要这些，直接访问 bangle.io 网站就能用，但前提是你的浏览器支持所需的文件系统 API。
性能宣称与真实限制：一万个文件之后
README 声称 Bangle 能处理大量笔记，还专门提到可以打开 10,000 个 Markdown 文件的项目。这个宣称听起来诱人，但没有任何基准数据支撑。浏览器能打开一万个文件，不代表编辑体验流畅。每个文件的解析、索引、渲染都会消耗内存，而浏览器对单页应用的内存限制是真实存在的。更重要的是，WYSIWYG 编辑器在大型文档上的性能通常不如纯文本编辑器。Bangle 的劣势在于它必须同时维护 Markdown 源码和富文本视图，这比只显示纯文本要重得多。如果你有几十个超长笔记，而不是一万个小文件，性能表现可能完全不同。这一点 README 没有提到，你需要自己测试。
扩展性与未兑现的承诺
Bangle.io 号称从底层就为扩展而设计，README 里说有一批社区扩展即将推出。但到目前为止，我们只能看到这个承诺，没有任何实际扩展的列表或文档。扩展机制是编辑器层面的还是应用层面的，README 没有说清楚。bangle.dev 作为编辑器框架，可能提供了一些插件接口，但应用层的扩展点是什么，完全不清楚。对于需要特定功能的用户，比如表格增强、双链、或导出 PDF，你没法知道能不能通过扩展实现。这种不确定性是采用它的一个障碍。如果你依赖某个特定功能，最好先确认它是否内置，或者扩展是否真的存在。
替代方案：Obsidian 与 Logseq 的差异
和 Bangle.io 最接近的替代品是 Obsidian 和 Logseq。Obsidian 也是本地 Markdown 文件，但它是桌面应用，基于 Electron，有成熟的插件市场，双链和图表功能内置。Logseq 同样本地优先，但它使用大纲结构，数据格式是 Markdown 和 org-mode 的混合。关键差异在于：Obsidian 和 Logseq 是桌面应用，不依赖浏览器，离线可用；Bangle.io 是纯网页应用，你必须打开浏览器才能用。另一个差异是许可证，Obsidian 是闭源免费软件，Logseq 是 AGPL 开源，但 Bangle 也是 AGPL。如果你需要离线桌面体验，Bangle 不是对手。如果你坚持开源，Bangle 和 Logseq 都是选项，但 Bangle 的 WYSIWYG 是 Logseq 不具备的。
维护与许可证：AGPL 的含义
Bangle.io 使用 AGPL-3.0 许可证，这是一个强 copyleft 许可证。如果你修改了 Bangle 的代码并部署为网络服务，你必须把修改后的源码公开。对于个人用户，这通常不是问题；但如果你打算基于 Bangle 构建商业产品，或者把它集成到内部工具里，AGPL 可能是个麻烦。维护方面，仓库的最近推送时间和版本发布信息都没有提供，这意味着我们无法判断项目是否活跃。没有发布记录是个警示信号，可能项目还在开发中，也可能已经停滞。在采用之前，你应该检查 GitHub 上的提交频率和 issue 处理情况，但本文只能告诉你这些信息缺失。
编辑结论
Bangle.io 适合那些已经习惯 Markdown 文件管理、希望笔记完全留在本地、并且愿意用浏览器作为唯一编辑环境的用户。它不适合需要离线桌面应用、需要插件生态成熟稳定、或者对 AGPL 许可证有顾虑的团队。在采用之前，先验证两件事：一是你的浏览器能否流畅处理大量 Markdown 文件，二是你能否接受 AGPL 对衍生作品的开源要求。如果这两点都能接受，Bangle.io 值得一试；否则，Obsidian 或 Logseq 可能是更稳妥的选择。
社区笔记