飞书文档现在可以从“下载为”菜单得到 Markdown。很多早期教程还停留在“只能导出 Word 和 PDF”,那套结论已经过时。
下载成功不等于文件能长期离线使用。图片、评论和复杂块,是最容易在导出后留下缺口的三类内容。
官方入口在哪里
打开一篇飞书文档,在右上角或更多菜单里找到“下载为”,选择 Markdown。不同版本可能有“仅文本”和“包含更多内容”之类的选项,实际名称以当前界面为准。
导出后得到的是 .md 文件,可以用普通文本编辑器、Obsidian、VS Code 或其他 Markdown 工具打开。
官方导出通常能保留什么
- 标题层级
- 列表、待办和引用
- 普通链接
- 基础表格
- 代码块
- 图片和附件的引用位置
对大多数文档来说,这已经足够继续编辑。
哪些内容仍需要注意
评论通常不会跟着走
评论是协作记录,不是正文块。需要长期保留的结论,最好在导出前复制进正文。
图片可能仍是在线地址
这是最常见的问题。Markdown 文件本身下载成功,但图片仍指向飞书地址。账号、权限或链接有效期变化后,图片可能失效。
如果你的目标是长期离线保存,就不能只看导出成功,还要检查图片是否真实落到了本地。
复杂结构可能简化
合并单元格、多列布局、高亮块、画板、流程图和目录块,在不同导出格式中可能发生结构变化。导出后应该逐项检查,而不是假设每个块都能完全还原。
官方导出和本地图片归档的区别
| 结果 | 官方 Markdown | Markdown + 本地图片 |
|---|---|---|
| 正文结构 | 通常保留 | 通常保留 |
| 图片 | 可能保存在线链接 | 下载到本地并通过相对路径引用 |
| 离线可用 | 取决于图片 | 断网后仍可打开 |
| 移动整个文件夹 | 图片可能断链 | 路径保持可用 |
| 适合场景 | 继续编辑、快速备份 | 长期归档、迁移和交接 |
如果只是把文档发给同事继续编辑,官方导出已经够用。如果要把资料放进个人知识库、备份到硬盘或交给 AI 当上下文,本地图片更重要。
导出后做一次三步检查
- 断开网络,打开 Markdown,看图片是否显示。
- 把
.md和图片目录一起移动,看路径是否断开。 - 搜索中间段落,确认正文没有只导出前半部分。
三步都通过,结果才适合放进长期归档。
官方导出不够时怎么办
需要批量处理、图片 ZIP、PDF 或单文件 HTML 时,可以在官方导出之外使用浏览器扩展补齐。
飞书工具箱的 Markdown 导出是免费的。Markdown 和图片 ZIP 会把图片按正文顺序放到本地,适合需要离线和可移植的场景,属于 Pro,可先试用。
最合理的组合
少量单篇文档先用官方导出,确认内容和格式。需要长期保存或迁移大量文档时,再用浏览器扩展或 API 补齐图片和批量流程。
不要因为旧教程说“飞书不支持 Markdown”就继续使用复杂脚本,也不要因为官方已经支持导出,就忽略图片和评论仍然需要单独处理。