一、先说一个每个人都遇到过的问题
你写了一份技术文档、一份项目总结、或者一组 API 说明,想发给同事或外部合作方看。
然后你会发现——
- 飞书/Notion:对方得注册、得登录、得加入空间,链接发出去经常打不开。
- GitHub Pages / VitePress:需要自己配置、自己部署、自己维护,改个标点都要 push + wait for CI。
- 直接发 Markdown 文件:对方下载下来用记事本打开,格式全丢,阅读体验极差。
- 导出 PDF:手机上看字小得离谱,电脑上看没法点击链接,更新后还得重新发。
写文档五分钟,分享文档一小时。 这件事的阻力大到让我很多时候干脆不发。
直到上个月,我发现了 Documind。
二、Documind 是什么?一句话说清
Documind = 写 Markdown → 用 CLI 上传 → 自动得到一个独立的、可分享的在线文档站点。
注册后,你会得到一个专属子域名,比如 your-team.documind.cn。这个地址就是你的文档站点——所有人打开就能看,不需要注册,不需要登录,不需要安装任何东西。
它的工作方式很直接:
- 本地写 Markdown:用你喜欢的任何编辑器(VS Code、Obsidian、Typora),保持你习惯的写作流程。
- CLI 一键上传:一条命令把本地文档同步到云端,自动渲染成漂亮的在线页面。
- 获得独立站点:文档上线后,直接分享
your-team.documind.cn/xxx的链接给别人。
简单来说:你的文档,终于有了一个可以直接发出去的「门面」。
三、它到底解决了什么痛点?
痛点 1:内部文档工具,「出不去」
飞书、Notion、语雀……这些工具写文档很爽,但分享时卡死在权限上。
- 外部合作方没有你们公司的飞书账号
- Notion 公开页面加载慢,还经常需要登录
- 每次加人都要调权限,链接发出去还担心泄露
Documind 的做法是:每个仓库本身就是一个独立的公开站点,数据隔离。你把需要对外展示的文档放进去,直接发链接——对方打开就能看,没有任何门槛。
当然,如果你不希望公开,也可以设置访问控制。但默认模式下,它就是为「可分享」而生的。
痛点 2:自己搭文档站点,维护成本高
很多技术团队用 GitHub Pages、VitePress、Docusaurus 搭文档站。效果好,但代价是:
- 需要写配置、调主题、处理部署
- 每次更新要 push、等 CI、看构建状态
- 团队成员要学会 Git 工作流才能贡献文档
- 一个人维护,其他人等着
Documind 的做法是:零配置。本地写好 Markdown,一条命令上传,立刻在线。没有 theme 配置,没有 build 步骤,没有 CI 等待。
这里有个取舍:它不像 VitePress 那样可以深度定制主题和插件。如果你需要高度自定义的交互式文档,可能还是自己搭更合适。但对于「内容优先」的文档场景,Documind 的默认渲染已经够用了。
痛点 3:文档和 AI 之间没有连接
这个算是意外收获。Documind 的文档站点底层实现了 MCP(Model Context Protocol) 协议,这意味着:
- 你的在线文档不仅是「给人看的」,也是「给 AI 读的」
- Claude、Cursor、Windsurf 等支持 MCP 的 AI 工具,可以直接调用你仓库里的文档
- AI 可以通过 Skills(如搜索、读取、按标签过滤)精确引用你的文档内容
这个能力是锦上添花,不是刚需。核心依然是「在线文档站点」——AI 调用只是让这份文档的价值多了一层。
四、具体怎么用?两步搞定
第一步:CLI 上传文档
# 安装 CLI
npm install -g documind-cli
# 登录
documind-cli login
# 创建仓库并上传本地 Markdown 文件夹
documind-cli repo create team-docs
documind-cli upload ./docs --repo team-docs
上传完成后,你的文档就在 team-docs.documind.cn 上线了。
第二步:分享链接
https://team-docs.documind.cn/getting-started
https://team-docs.documind.cn/api-reference
直接发给同事、合作方、面试官、投资人……对方打开即用。
如果你也使用 Claude / Cursor 等 AI 工具,可以额外运行一条命令接入 MCP:
npx -y documind-cli@latest mcp --name team-docs --token <你的 token>这样 AI 就能直接检索和引用你的文档内容了。但这是可选项,不是必选项。
五、适合什么场景?不适合什么场景?
先说适合的场景:
| 场景 | 为什么适合 |
|---|---|
| 团队技术文档 | API 文档、设计规范、部署手册,直接发链接给全团队,外部合作方也能看 |
| 个人工作成果展示 | 项目总结、技术博客、作品集,把链接放在简历或个人主页里 |
| 开源项目文档 | 项目 README + 详细文档一体化,社区用户无需跳转多个平台 |
| 课程/教程内容 | 系列教程整理成在线站点,学生直接浏览,不用发 PDF |
| 产品帮助中心 | 轻量级的产品说明文档,快速上线,比自建站点省事 |
再说不太适合的场景:
- 如果你需要多人实时协作编辑(类似飞书文档那种多人同时打字),Documind 目前不是协作编辑器,更接近「发布平台」
- 如果你需要复杂的权限体系(部门级、角色级、文档级细粒度权限),它目前偏轻量
- 如果你需要非 Markdown 格式(Word、PPT、Excel)的在线预览,目前主要面向 Markdown 生态
- 如果你需要高度自定义的主题和插件(如 VitePress 那种深度定制),默认渲染可能不够用
六、我的真实使用体验
我把团队的技术文档、个人的项目笔记、还有一些写了一半的博客草稿,全部用 Documind 托管了。
几个直观感受:
- 发链接代替发文件:以前给合作方发 API 文档要导出 PDF 或者拉进飞书空间,现在直接甩一个链接,对方秒开。
- 团队内部省了无数「翻文档」的时间:设计规范、接口约定、部署流程全在站点上,新同学入职第一天就能看完,不用再问老员工「那个文档在哪」。
- 个人作品多了一个展示入口:我把做过的一些项目文档整理成了一个站点,链接放在简历里,面试官可以直接浏览——比 GitHub 仓库更有「可读性」。
- 写作流程没变:我还是用 VS Code 写 Markdown,用 Git 管理版本,唯一多的一步是
documind-cli upload,习惯后无感。 - AI 调用是意外收获:我们团队在 Cursor 里写代码时,AI 可以直接引用文档站点里的接口规范,不用复制粘贴。但这属于「有了更好」,不是用它的初衷。
七、最后说几句实话
Documind 不是一个「万能文档平台」。它是一个让 Markdown 文档快速变成可分享在线站点的最简路径。
如果你符合以下任意一条,它值得试:
- 你有一堆 Markdown 文档,想给它们一个「可以发出去的地址」
- 你的团队技术文档散落在各个地方,想统一成一个可浏览的站点
- 你需要对外分享项目文档、API 说明、设计规范,但不想让对方注册登录
- 你想把个人项目或工作成果整理成在线展示页
注册免费,专属子域名开通即用。我这篇文章不是 sponsored,只是真心觉得:在这个每个人都需要写文档、但分享文档体验极差的时代,有一个「写 Markdown → 自动变网站」的工具,能省下太多心力。
如果你已经在用类似方案,欢迎在评论区交流。如果你还没试过,花 3 分钟上传一篇文档看看效果——然后告诉我:分享文档这件事,是不是真的变简单了?