一个 Chrome 插件搞定飞书文档转 Markdown

在飞书上看到一篇不错的文档，想保存下来以便后续查阅。复制粘贴过去一看，会发现要么复制不了，要么格式全废了——标题变成了普通文字，代码块没了，表格直接散架。

飞书到现在都没有原生的 Markdown 导出功能，以后估计也不会出。

Cloud Document Converter 就是干这件事的：装上这个浏览器扩展，打开飞书文档，点击右下角下载小图标，标题、代码块、表格、图片全给你转好。有图片的话还会自动打包成一个 ZIP 文件下载下来。

免费，开源，不用注册，不用上传文档到任何服务器。

下面按步骤讲怎么用。

安装

三个浏览器都能装，选你用的：

打开链接，点"安装"，没有额外配置。安装完成后扩展会自动在飞书文档页面生效。

下载为 Markdown（含图片）

推荐用这种方式，因为图片会一起下载。

操作步骤：

1. 用浏览器打开飞书文档页面（比如 https://xxx.feishu.cn/docx/...）
2. 通过以下任一入口触发下载：
   • 右键页面 → "下载为 Markdown"
   • 点击浏览器工具栏扩展图标 → 下载按钮
   • 点击页面右下角的下载小图标
3. 扩展自动开始转换和下载

下载过程发生了什么：

• 扩展先检测文档是否完全加载，文档过长时会自动滚动页面触发懒加载
• 将飞书文档的块结构（block tree）逐个转换为 Markdown AST 节点
• 并发下载文档中所有图片（最多 15 张同时下载）
• 有图片或附件 → 打包成 ZIP（含 .md 文件 + images/ 文件夹）
• 无图片 → 直接下载一个 .md 文件

下载过程中不要刷新或关闭页面。扩展会在飞书页面右上角显示 Toast 通知，告诉你当前进度。

复制为 Markdown（纯文本）

只需要文本、不需要图片文件时用这种方式。

1. 打开飞书文档
2. 右键点击页面 → "Copy as Markdown"
3. Markdown 文本已复制到剪贴板，粘贴到任何地方即可

注意：复制方式生成的图片 URL 只有 2 小时有效期，过期后图片无法访问。需要长期保存图片请用"下载"方式。

支持哪些格式

块级元素

行内元素

日常写作中用到的格式基本都覆盖了。标题、列表、表格、代码块、图片、公式这些高频元素全部支持。

它是怎么工作的

Cloud Document Converter 不是通过飞书开放平台的 API 获取文档内容的。它直接读取飞书页面中已经渲染好的文档数据结构。

飞书文档在浏览器中以 block tree 树形结构存在，每个段落、标题、图片都是一个 block，block 之间有父子关系。扩展的核心引擎（开源为 @dolphin/lark 包）做的事情是：

1. 获取文档的根 block
2. 递归遍历每个 block，根据类型创建对应的 Markdown AST 节点
3. 处理行内富文本（加粗、链接、代码等）的属性叠加
4. 用 mdast-util-to-markdown 将 AST 序列化为 Markdown 字符串

整个过程完全在浏览器客户端完成，不经过任何外部服务器。

常见问题

长文档下载不完整？

飞书文档使用懒加载，只有滚动到可视区域的内容才会加载。扩展会自动滚动触发加载，但网络较慢时可能需要多等一会。

如果下载不完整，先手动把文档从头到尾滚动一遍，确保所有内容都已加载，然后再执行下载。

图片链接失效了？

"复制为 Markdown" 方式的图片 URL 只有 2 小时有效期，这是飞书本身的限制。解决方法：用"下载为 Markdown"方式，图片会被保存到本地。

某些格式没转出来？

对照上面的兼容性表格检查。高亮块会降级为引用，分栏内容会被扁平化，多维表格和思维笔记暂不支持。这些是已知的限制，项目还在持续更新中。

支持飞书的哪些域名？

所有飞书相关域名都支持：feishu.cn、feishu.net、larksuite.com、larkoffice.com、larkenterprise.com 等。国内版飞书和国际版 Lark 都能用。

适合你的场景吗

• 你日常使用飞书/Lark 写文档或浏览文档
• 你需要把飞书文档内容发布到博客、GitHub、静态网站
• 你用 Obsidian/Notion/Logseq 等 Markdown 工具做知识管理
• 你不想手动复制粘贴再调格式
• 你希望图片能一起下载，不只是链接

以上有 2 条以上命中你，直接装。

项目完全开源（MIT 协议），源码在 GitHub，遇到问题可以提 Issue。