我厌倦了把文档锁在飞书里,直到发现可以直接把它变成一个网站

11 阅读7分钟

一、先说一个每个人都遇到过的问题

你写了一份技术文档、一份项目总结、或者一组 API 说明,想发给同事或外部合作方看。

然后你会发现——

  • 飞书/Notion:对方得注册、得登录、得加入空间,链接发出去经常打不开。
  • GitHub Pages / VitePress:需要自己配置、自己部署、自己维护,改个标点都要 push + wait for CI。
  • 直接发 Markdown 文件:对方下载下来用记事本打开,格式全丢,阅读体验极差。
  • 导出 PDF:手机上看字小得离谱,电脑上看没法点击链接,更新后还得重新发。

写文档五分钟,分享文档一小时。 这件事的阻力大到让我很多时候干脆不发。

直到上个月,我发现了 Documind


二、Documind 是什么?一句话说清

Documind = 写 Markdown → 用 CLI 上传 → 自动得到一个独立的、可分享的在线文档站点。

注册后,你会得到一个专属子域名,比如 your-team.documind.cn。这个地址就是你的文档站点——所有人打开就能看,不需要注册,不需要登录,不需要安装任何东西。

它的工作方式很直接:

  1. 本地写 Markdown:用你喜欢的任何编辑器(VS Code、Obsidian、Typora),保持你习惯的写作流程。
  2. CLI 一键上传:一条命令把本地文档同步到云端,自动渲染成漂亮的在线页面。
  3. 获得独立站点:文档上线后,直接分享 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 托管了。

几个直观感受:

  1. 发链接代替发文件:以前给合作方发 API 文档要导出 PDF 或者拉进飞书空间,现在直接甩一个链接,对方秒开。
  2. 团队内部省了无数「翻文档」的时间:设计规范、接口约定、部署流程全在站点上,新同学入职第一天就能看完,不用再问老员工「那个文档在哪」。
  3. 个人作品多了一个展示入口:我把做过的一些项目文档整理成了一个站点,链接放在简历里,面试官可以直接浏览——比 GitHub 仓库更有「可读性」。
  4. 写作流程没变:我还是用 VS Code 写 Markdown,用 Git 管理版本,唯一多的一步是 documind-cli upload,习惯后无感。
  5. AI 调用是意外收获:我们团队在 Cursor 里写代码时,AI 可以直接引用文档站点里的接口规范,不用复制粘贴。但这属于「有了更好」,不是用它的初衷。

七、最后说几句实话

Documind 不是一个「万能文档平台」。它是一个让 Markdown 文档快速变成可分享在线站点的最简路径

如果你符合以下任意一条,它值得试:

  • 你有一堆 Markdown 文档,想给它们一个「可以发出去的地址」
  • 你的团队技术文档散落在各个地方,想统一成一个可浏览的站点
  • 你需要对外分享项目文档、API 说明、设计规范,但不想让对方注册登录
  • 你想把个人项目或工作成果整理成在线展示页

官网:www.documind.cn

注册免费,专属子域名开通即用。我这篇文章不是 sponsored,只是真心觉得:在这个每个人都需要写文档、但分享文档体验极差的时代,有一个「写 Markdown → 自动变网站」的工具,能省下太多心力。

如果你已经在用类似方案,欢迎在评论区交流。如果你还没试过,花 3 分钟上传一篇文档看看效果——然后告诉我:分享文档这件事,是不是真的变简单了?