Cloud Document Converter

飞书文档是现在很多团队使用的协作工具，界面好看，功能也强。但有一件事比较麻烦：它不支持直接导出为Markdown格式。如果你想把飞书上的文档转移到他平台，比如GitHub、语雀、Obsidian或者本地笔记软件，要么手动复制粘贴然后重新调整格式，要么另存为Word或PDF再转换，过程很折腾。

Cloud Document Converter就是来解决这个问题的。它由开发者whale4113创建，是一个开源的浏览器扩展。安装之后，在你打开的飞书文档页面任意位置点击右键，菜单里会多出两个选项：“下载为Markdown”和“复制为Markdown”。选择前者，插件会开始解析当前文档，把所有的内容元素——包括标题层级、列表、表格、代码块、引用、图片链接，甚至行内数学公式——都转换成对应的Markdown语法，然后自动下载一个.md文件到本地。

这个插件对飞书文档的兼容性做得相当不错。常见的元素基本都支持，表格能保留行列结构，图片会提取出URL（虽然有时效性），列表的嵌套也能正确处理。对于飞书特有的某些复杂模块，比如流程图、UML图、看板等，支持度有限，但开发者还在持续更新。项目在GitHub上开源，目前已积累超过1000颗星，最近一次更新就在2026年4月，维护比较活跃。

官网入口地址

https://www.appawesome.me/cloud-document-converter

GitHub开源项目地址

https://github.com/whale4113/cloud-document-converter

下载地址

可以通过以下浏览器的官方扩展商店安装：

• Chrome网上应用店：搜索“Cloud Document Converter”

• Microsoft Edge加载项：搜索“Cloud Document Converter”

• Firefox附加组件：搜索“Cloud Document Converter”

由于国内访问谷歌商店不稳定，也可以在第三方插件平台搜索同名插件下载crx文件离线安装。

功能介绍

核心转换功能
将飞书文档完整转换为Markdown格式。转换范围包括：文档标题、正文段落、1到6级标题（7到9级标题会转为普通段落）、粗体、斜体、删除线、下划线、行内代码、代码块、有序列表、无序列表、任务列表、引用块、分割线、表格、图片、内联数学公式等。

两种输出方式

• 下载为Markdown：插件将转换后的内容保存为一个.md文件，自动下载到浏览器的默认下载文件夹。

• 复制为Markdown：只把转换后的Markdown源码复制到剪贴板，不生成文件。适合你只想粘贴到他地方（比如在线编辑器、笔记软件）的场景。

保留原始结构
转换后的Markdown文档会尽量保持飞书原文的排版逻辑。标题层级对应、列表缩进正确、表格行列对齐、代码块的语言标注也会保留。

图片处理
文档中的图片会被提取出URL，以Markdown图片语法![描述](图片URL)的形式嵌入。需要特别注意：飞书生成的图片URL有效期只有2小时。这意味着转换后超过2小时，图片链接就会失效，无法再显示。如果需要长期保存图片，建议在转换后尽快将图片下载到本地，或者使用他工具将图片转为本地存储。

复杂元素降级处理
对于飞书文档中一些Markdown没有直接对应语法的元素，插件采用了降级策略：

• 高亮块（Call Out）：转换为普通引用块

• 流程图、UML图：目前支持下载为图片，再以图片形式嵌入

• 网格布局：会被展平，或转换为表格/HTML

• 文件附件：转换为下载链接

• 内嵌网页（Iframe）：转换为HTML代码

跨浏览器支持
插件同时支持Chrome、Edge和Firefox三大主流浏览器，在不同浏览器上的功能和操作方式基本一致。

开源与可贡献
项目代码开源在GitHub上，采用MIT许可证。开发者提供了详细的贡献指南，如果你懂TypeScript和Vue，可以自己修复bug或者增加对新元素的支持，然后提交拉取请求。

捐赠支持
开发者提供了“Buy me a coffee”的赞助链接，如果你觉得这个工具帮助很大，可以自愿请作者喝杯咖啡。但不是必须的，不影响任何功能。

应用场景

将飞书文档迁移到Markdown平台
假设你所在的团队之前用飞书文档写技术方案，现在要整体迁移到GitHub Wiki或者语雀。用Cloud Document Converter可以把每篇飞书文档快速转成Markdown，然后直接导入新平台，不需要手动重排格式。

备份飞书文档到本地
飞书是云端服务，文档存在别人的服务器上。如果你想把重要的文档在本地也存一份，可以用这个插件转成Markdown，保存到自己的电脑或NAS里。Markdown是纯文本格式，即使再过十年也能用任意文本编辑器打开。

用本地编辑器继续编辑
有些技术人员习惯用VS Code、Typora或Obsidian来写文档，因为支持快捷键、插件扩展和本地搜索。但团队协作又不得不用飞书。你可以先在飞书里写好初稿，然后用这个插件导出Markdown，再到本地编辑器里精修和存档。

飞书文档转个人知识库
很多人用Obsidian或Logseq这类双链笔记软件来构建个人知识库。飞书上看到的好文章、学习笔记，可以一键导出为Markdown，然后放进自己的知识库里，加上标签和双向链接，方便以后检索。

技术文档格式转换
技术文档中经常包含代码块、表格、数学公式。飞书对这些元素的支持不错，但导出功能有限。Cloud Document Converter可以比较完整地保留这些技术性内容的结构，减少转换后的手动修正工作。

定价及重要信息

定价策略
Cloud Document Converter免费。无论是从官方扩展商店安装，还是从GitHub下载源码自行编译，都不需要付费。开发者没有设置专业版或收费功能。

开源协议
项目采用MIT许可证，这是最宽松的开源协议之一。你可以自由使用、修改、分发，甚至可以把它集成到自己的商业项目中，只需要保留原始的版权声明。

更新与维护
从GitHub的提交记录来看，开发者whale4113和社区的几位贡献者在持续维护这个项目。最近的更新在2026年4月，增加了对表格合并单元格（rowspan/colspan）的支持，以及对下划线样式的转换。项目的Issue和拉取请求响应比较积极。

限制与注意事项
最重要的限制是图片URL的有效期只有2小时。转换后的Markdown文件如果包含图片，建议在2小时内处理这些图片（比如下载到本地，然后修改md文件中的图片路径），否则链接会失效。对于非常复杂的飞书文档（如包含大量图表、看板、多维表格），转换结果需要手动调整。

隐私与安全
插件在转换过程中需要读取你当前打开的飞书文档内容，这是它工作的基础。开发者声明插件仅用于格式转换，不会收集或上传你的文档数据。但由于它不是离线纯本地转换（部分资源需要从飞书服务器获取），理论上飞书方面能看到你的访问行为。如果你处理的是高度机密的文档，建议谨慎评估。