诚实对比 · Doco 与 HackMD

Doco vs HackMD

如果你需要实时协作的 Markdown、团队工作区,以及把笔记发布为网页、幻灯片或书籍,可以选择 HackMD。如果你需要稳定块 ID 与受保护的结构化编辑,可以选择面向 Agent 的 Doco 共享文档。HackMD 也提供支持 OAuth 登录的官方托管 MCP 服务。

直接答案

按工作选择,
别按功能数量

这些产品有重叠,但重心不同。先确定事实源是什么,以及哪些人和 Agent 必须共同维护它。

这些情况选择 Doco

  • 工作流依赖稳定块 ID 和 If-Match 保护的 Agent 写入。
  • MIT 许可与自托管是明确要求。
  • Claude Code、Cursor 和 Codex 需要通过 MCP、CLI 或 API 读写共享文档。

这些情况选择 HackMD

  • 实时协作 Markdown 与团队工作区符合你的知识库需求。
  • 把笔记发布为网页、幻灯片或书籍是工作流的重点。
  • 你希望使用 OAuth 登录的官方托管 MCP,并保留笔记修订历史。
一眼对比

实际运行差异

维度DocoHackMD
核心工作Agent 安全协作文档协作 Markdown 编辑器与知识库
数据所有权MIT 许可应用与自托管笔记可组织到团队工作区
人类协作Yjs 实时编辑与浏览器本地持久化实时协作 Markdown 编辑
Agent 接入29 工具 MCP、CLI、REST、稳定 ID 与 If-Match托管 MCP 使用 OAuth;REST API 与 CLI 使用个人令牌
内容模型文档/块模型,嵌入表格和电子表格Markdown 笔记;MCP update-note 覆盖整篇内容
最适场景Agent 维护书面知识的团队以 Markdown 协作并发布网页、幻灯片或书籍的团队

HackMD 更强的地方

当重点是 Markdown 协作,以及把笔记发布为网页、幻灯片或书籍时,HackMD 很适合。它的官方托管 MCP 服务允许 Agent 在连接账户可访问的工作区与笔记范围内操作。Agent 编辑会保留修订记录;Prime 与 Enterprise 保留无限版本。

Doco 更强的地方

当稳定块 ID、Markdown 往返与 MIT 自托管更重要时,Doco 更适合。人与 AI Agent 通过 MCP、CLI 或 API 共享文档,并使用 If-Match 保护的块级编辑。HackMD MCP 同样支持 Agent 写入,但其 update-note 工具会覆盖整篇笔记内容,该工具不提供章节或块级补丁,也没有预期修订版本校验。修订历史支持编辑后的审阅,与写入时的版本校验是不同机制。

迁移

从 HackMD 迁移

先选取有代表性的 Markdown 笔记试用,再调整工作流。保留原始内容与附件副本,将 Markdown 导入 Doco,并分别检查格式、组织方式与发布需求。

  1. 01

    保留有代表性的 HackMD 笔记内容与相关附件副本。

  2. 02

    把 Markdown 导入 Doco,并用知识库与文件夹组织文档。

  3. 03

    检查格式与附件;单独核对团队组织,以及网页、幻灯片或书籍的发布需求。

  4. 04

    让 Agent 试用稳定块 ID 与 If-Match,再决定哪些 Markdown 与发布工作流继续留在 HackMD。

先用真实数据做小范围演练。在链接、附件、权限、表格和恢复流程都验收前,保留原始导出。

Bottom line

选择更小的事实源

如果重点是 Markdown 协作、团队工作区、发布与官方 OAuth MCP,可以选择 HackMD。如果重点是面向 Agent 的文档、稳定块地址、受保护的结构化编辑与 MIT 自托管,可以考虑把 Doco 作为 HackMD 替代方案。两者都支持 Agent 编辑与人工审阅,编辑契约各有侧重。

01HackMD 有官方 MCP 服务吗?

有。https://mcp.hackmd.io/ 是官方托管的远程 MCP 服务,使用 Streamable HTTP 与带 PKCE 的 OAuth 2.1。MCP 不需要 API 令牌。Agent 的操作范围是连接账户可以访问的工作区与笔记。

02HackMD MCP 如何更新与审阅笔记?

笔记工具包括 list-notes、get-note、create-note、update-note、delete-note(移至回收站)和 get-history。update-note 覆盖整篇内容,该工具没有章节或块级补丁,也没有预期修订版本校验。Agent 编辑会保留修订记录;Prime 与 Enterprise 保留无限版本。

03HackMD REST API、CLI 与 MCP 使用相同的认证吗?

不同。api.hackmd.io 的 REST API 与 CLI 使用个人 API 令牌,与 MCP 的 OAuth 独立。所有套餐均可访问 API:Free 每月 400 次调用,Prime 每月 20,000 次,Enterprise 不限次数。