开源自托管协作笔记HedgeDoc，7k Star的实时Markdown编辑器

HedgeDoc 在 GitHub 上获得了 7,185 个 Star，是一个在线实时协作的 Markdown 编辑器。项目灵感来自 Hackpad 和 Etherpad，最初由 HackMD 团队创建，后独立发展运营。

对于需要私有化部署协作工具的团队，HedgeDoc 可以直接跑在自有服务器上，数据和账号完全自主掌控。

核心功能：多人实时编辑 Markdown

HedgeDoc 做的是 Markdown 版的在线协作。多人同时编辑同一份文档，每个人的修改实时同步。编辑界面分两栏，左边写 Markdown 源码，右边渲染预览。如果团队中有人更习惯所见即所得的体验，也可以直接在预览区操作。

和 Confluence、Notion 这类通用协作工具不同，HedgeDoc 只做 Markdown。结果就是功能聚焦，纯文本格式方便版本管理，迁移成本也低。

认证对接：接入现有账号体系

内部工具推广的一个难点是需要额外账号体系。让人再注册一套新账号，使用意愿会打折扣。HedgeDoc 支持 OAuth2 协议，可以对接 GitHub、GitLab、Google、Facebook、Twitter 的社交登录。企业环境还支持 LDAP 和 SAML，已有账号体系的团队无需单独注册。

权限上，笔记可设为公开、仅登录可见、指定用户可见三档。文档下方有评论功能，支持协作讨论。

存储后端：支持 S3 / MinIO / Azure

笔记工具绕不开文件存储。HedgeDoc 支持本地上传，也支持 S3、MinIO、Azure Blob Storage 和 Imgur 四种远端存储。团队如果用 MinIO 搭建了私有对象存储，直接配置即可接入。所有文件存储在自己管控的服务器上。Dropbox 也支持用于文档的导入和导出。

部署：Docker 一行命令启动

HedgeDoc 提供五种部署方式：Docker、Cloudron、LinuxServer.io 多架构镜像、Heroku 和手动安装。其中 Docker 最常用，准备一个 PostgreSQL 数据库，一行命令即可启动。官方文档对每种部署方式都有配置说明。

适用场景

技术团队的内部文档。技术团队对 Markdown 接受度高，用 HedgeDoc 写 API 文档、系统设计、会议纪要，流程比来回传文件高效。

数据合规要求高的组织。金融、医疗、政务等行业，HedgeDoc 部署在内网，数据不出企业边界。

HedgeDoc 采用 AGPLv3 协议开源，社区有配套的命令行工具 hedgedoc-cli，可以在终端查看和编辑文档。

需要注意

HedgeDoc 目前仍在开发迭代中，权限控制粒度、审计日志等企业功能可能需要二次开发。浏览器兼容方面，支持 Chrome 47+、Firefox 44+、Safari 10.1+、Edge 14+，主流浏览器均可正常使用。

备份逻辑比较直接：备份数据库、配置文件、上传目录三样，恢复时还原这三样即可。

总结

HedgeDoc 的定位是面向 Markdown 用户的实时协作笔记，价值在于私有化部署。认证对接、存储后端、部署方式都考虑了实际使用场景，对需要自托管文档协作的团队是一个值得评估的选项。

对接、存储后端、部署方式都考虑了实际使用场景，对需要自托管文档协作的团队是一个值得评估的选项。