这些情况选择 Doco
- 工作流依赖稳定块 ID 和 If-Match 保护的 Agent 写入。
- MIT 许可与自托管是明确要求。
- Claude Code、Cursor 和 Codex 需要通过 MCP、CLI 或 API 读写共享文档。
如果你需要实时协作的 Markdown、团队工作区,以及把笔记发布为网页、幻灯片或书籍,可以选择 HackMD。如果你需要稳定块 ID 与受保护的结构化编辑,可以选择面向 Agent 的 Doco 共享文档。HackMD 也提供支持 OAuth 登录的官方托管 MCP 服务。
这些产品有重叠,但重心不同。先确定事实源是什么,以及哪些人和 Agent 必须共同维护它。
| 维度 | Doco | HackMD |
|---|---|---|
| 核心工作 | Agent 安全协作文档 | 协作 Markdown 编辑器与知识库 |
| 数据所有权 | MIT 许可应用与自托管 | 笔记可组织到团队工作区 |
| 人类协作 | Yjs 实时编辑与浏览器本地持久化 | 实时协作 Markdown 编辑 |
| Agent 接入 | 29 工具 MCP、CLI、REST、稳定 ID 与 If-Match | 托管 MCP 使用 OAuth;REST API 与 CLI 使用个人令牌 |
| 内容模型 | 文档/块模型,嵌入表格和电子表格 | Markdown 笔记;MCP update-note 覆盖整篇内容 |
| 最适场景 | Agent 维护书面知识的团队 | 以 Markdown 协作并发布网页、幻灯片或书籍的团队 |
当重点是 Markdown 协作,以及把笔记发布为网页、幻灯片或书籍时,HackMD 很适合。它的官方托管 MCP 服务允许 Agent 在连接账户可访问的工作区与笔记范围内操作。Agent 编辑会保留修订记录;Prime 与 Enterprise 保留无限版本。
当稳定块 ID、Markdown 往返与 MIT 自托管更重要时,Doco 更适合。人与 AI Agent 通过 MCP、CLI 或 API 共享文档,并使用 If-Match 保护的块级编辑。HackMD MCP 同样支持 Agent 写入,但其 update-note 工具会覆盖整篇笔记内容,该工具不提供章节或块级补丁,也没有预期修订版本校验。修订历史支持编辑后的审阅,与写入时的版本校验是不同机制。
先选取有代表性的 Markdown 笔记试用,再调整工作流。保留原始内容与附件副本,将 Markdown 导入 Doco,并分别检查格式、组织方式与发布需求。
保留有代表性的 HackMD 笔记内容与相关附件副本。
把 Markdown 导入 Doco,并用知识库与文件夹组织文档。
检查格式与附件;单独核对团队组织,以及网页、幻灯片或书籍的发布需求。
让 Agent 试用稳定块 ID 与 If-Match,再决定哪些 Markdown 与发布工作流继续留在 HackMD。
先用真实数据做小范围演练。在链接、附件、权限、表格和恢复流程都验收前,保留原始导出。
如果重点是 Markdown 协作、团队工作区、发布与官方 OAuth MCP,可以选择 HackMD。如果重点是面向 Agent 的文档、稳定块地址、受保护的结构化编辑与 MIT 自托管,可以考虑把 Doco 作为 HackMD 替代方案。两者都支持 Agent 编辑与人工审阅,编辑契约各有侧重。
有。https://mcp.hackmd.io/ 是官方托管的远程 MCP 服务,使用 Streamable HTTP 与带 PKCE 的 OAuth 2.1。MCP 不需要 API 令牌。Agent 的操作范围是连接账户可以访问的工作区与笔记。
笔记工具包括 list-notes、get-note、create-note、update-note、delete-note(移至回收站)和 get-history。update-note 覆盖整篇内容,该工具没有章节或块级补丁,也没有预期修订版本校验。Agent 编辑会保留修订记录;Prime 与 Enterprise 保留无限版本。
不同。api.hackmd.io 的 REST API 与 CLI 使用个人 API 令牌,与 MCP 的 OAuth 独立。所有套餐均可访问 API:Free 每月 400 次调用,Prime 每月 20,000 次,Enterprise 不限次数。