Docmost 使用教程
从入门到精通的完整指南
Docmost 简介
Docmost是开源的团队协作文档和知识库平台，定位为Notion和Confluence的替代品。基于TypeScript构建，支持实时协作编辑、文档树组织、权限管理等核心功能。Docmost提供所见即所得的富文本编辑器，支持Markdown语法、代码块、表格、图片等多种内容类型。平台内置空间（Space）和页面层级管理，团队可以按项目或部门组织文档结构。Docmost支持Docker自托管部署，数据完全存储在自有服务器，适合注重数据安全的团队。项目采用AGPL-3.0许可证，提供免费的社区版和付费的商业版，是近年来增长较快的开源文档协作工具。
详细功能介绍
【工具简介】Docmost是开源自托管的团队文档和知识库平台，提供实时协作编辑和文档管理能力，可替代Notion和Confluence。
【核心功能】
①实时协作编辑：支持多人同时编辑同一文档，实时同步内容变更，配合评论和@提及功能实现高效团队协作。
②富文本编辑器：提供所见即所得的编辑体验，支持Markdown快捷语法、代码块、表格、图片、嵌入内容等多种元素。
③文档组织管理：通过空间和页面层级结构组织文档，支持拖拽排序、页面模板、收藏夹等功能，构建清晰的知识体系。
④权限精细控制：支持空间级别和页面级别的权限设置，可配置查看、编辑、管理等不同角色，保障文档安全。
⑤全文搜索检索：内置全文搜索引擎，支持对文档标题和内容进行快速检索，帮助团队成员快速定位所需信息。
【适用场景】
技术团队搭建内部技术文档库，将API文档、架构设计、操作手册等集中管理，新成员入职时可快速查阅学习；产品团队管理需求文档和产品知识库，利用协作编辑功能进行需求评审和文档迭代；创业团队作为统一的团队知识平台，替代分散在各处的文档，实现信息的高效共享和沉淀。
【快速入门】
①部署Docmost：使用官方Docker Compose文件启动服务，包含应用服务和PostgreSQL数据库，配置域名和环境变量后即可访问。
②创建空间：登录后创建团队空间，设置空间名称和描述，邀请团队成员加入。
③编写文档：在空间内创建页面，使用富文本编辑器编写内容，支持从Markdown粘贴自动转换格式。
④分享与协作：通过链接分享文档给团队成员，设置查看或编辑权限，利用评论功能进行讨论反馈。
【优缺点分析】
优点：界面设计现代简洁，编辑体验流畅接近Notion；自托管保障数据安全，适合对隐私敏感的团队；开源可扩展，支持API集成和自定义开发。
缺点：功能成熟度与Notion、Confluence相比仍有差距，部分高级功能缺失；生态和插件体系尚不完善，第三方集成选项有限；社区版用户数和功能有一定限制。
【适合人群】
中小型技术团队，需要自托管的文档协作平台管理内部知识；创业团队和初创公司，寻找免费或低成本的Notion替代方案；注重数据安全的企业，要求文档数据存储在自有服务器上。
1Docmost入门教程：开源自托管的团队文档协作平台
入门10分钟
Docmost是一款开源的团队文档和知识库平台，支持实时协作编辑和文档树管理，可Docker自托管部署，是Notion和Confluence的轻量替代品。
快速开始：
1. 使用Docker部署：准备好服务器环境，执行官方提供的docker-compose命令一键启动
2. 部署完成后访问服务器地址，首次进入创建管理员账号
3. 创建工作空间并邀请团队成员加入，即可开始协作编写文档
核心功能演示：
功能一：富文本编辑与实时协作
新建页面后进入编辑器，支持所见即所得的富文本编辑。可以插入标题、列表、表格、代码块、图片等内容。多人同时编辑同一页面时，所有人的光标和修改实时可见，协作体验流畅。
功能二：文档树与空间管理
左侧边栏展示文档树结构，可以通过拖拽调整页面层级和顺序。创建不同的Space（空间）来分类管理文档，例如按项目创建产品文档技术文档运营文档等空间，保持知识库结构清晰。
功能三：权限与成员管理
在空间设置中可以配置成员权限，区分管理员、编辑者和只读成员。支持设置页面级别的访问控制，确保敏感文档只有授权人员可以查看或编辑。
实际使用案例：
场景一：创业团队知识库
一支10人的创业团队用Docmost搭建内部wiki，将产品需求文档、API接口说明、会议记录统一管理。新成员入职时通过文档树快速了解项目全貌，减少了重复沟通成本。
场景二：技术团队文档协作
后端团队使用Docmost编写技术方案和运维手册，代码块支持语法高亮，技术文档阅读体验好。配合权限管理，客户相关文档对内公开对外保密。
常见问题FAQ：
问：Docmost和Notion相比有什么优势？
答：Docmost完全开源可自托管，数据存在自己的服务器上，没有订阅费用，适合对数据安全有要求的团队。功能上覆盖了Notion的核心文档协作能力。
问：支持Markdown吗？
答：支持。编辑器同时提供富文本模式和Markdown模式，可以用Markdown语法快速编写，也可以用工具栏按钮操作，两种方式可以混用。
问：部署需要什么服务器配置？
答：最低1核CPU、1GB内存即可运行小型团队使用。团队规模较大或文档量多时建议2核4GB以上配置，数据库建议使用PostgreSQL。
小贴士：
1. 善用文档树的层级结构，合理的目录组织能让团队快速找到所需文档
2. 重要文档建议设置只读权限，避免被误修改
3. 定期使用Docker备份数据库，防止服务器故障导致数据丢失