十几张图还能右键保存。到了两百张，文件名是哈希，顺序全乱，正文里的图片和本地文件很快对不上。
有用的结果只有一个：图片能和 Markdown 一起移动、打开和备份。
手动保存为什么会失控
- 每张图片都要单独点击。
- 文件名可能重复或没有任何语义。
- 图片顺序与正文顺序不一致。
- 原图、缩略图和重复图片混在一起。
- 不检查时很难知道有没有漏图。
一旦数量上去，人工整理的成本会超过导出本身。
文档里的“附件”不止图片
飞书文档里可能包含：
| 类型 | 处理方式 |
|---|---|
| 正文图片 | 放入 assets 或图片目录，用相对路径引用 |
| 上传文件 | 单独保存，正文保留链接说明 |
| PDF、Word 等文档 | 不建议塞进 Markdown 内联 |
| 视频与大文件 | 单独资源目录或保留原地址 |
| 表格中的图片 | 导出后单独检查，容易被忽略 |
不是所有附件都适合打包进同一个 ZIP。大型视频和敏感文件可以单独处理。
一个可用的图片目录应该是什么样
document.md
assets/
001_cover.png
002_process-diagram.png
003_results.png推荐规则：
- 按正文出现顺序编号。
- 保留可读的原始文件名或简短语义。
- Markdown 使用相对路径。
- 移动整个目录时路径不断开。
- 断网打开时图片仍显示。
如果只是把图片下载到系统下载目录，然后再手动改路径，下一次文档更新时又要重做一遍。
两种做法
脚本下载
脚本适合开发者做一次性迁移。它需要处理登录、防盗链、重名和替换 Markdown 链接。灵活，但维护成本高。
扩展一键保存
浏览器扩展在导出时读取正文图片，按顺序下载，并和 Markdown 一起打包。飞书工具箱的 Markdown + 图片 ZIP 就是这个流程，属于 Pro，可先免费试用。
下载后必须检查什么
- 文件总数是否与文档图片数量大致一致。
- 图片是否按正文顺序排列。
- Markdown 里是否存在断链或空路径。
- 压缩包解压后能否在另一台设备打开。
- 是否误把不该保留的内部图片一起导出。
什么时候不需要图片 ZIP
文档只有一两张图，或者图片是公开网络图片，手动保存更简单。只导出 Markdown 文本、不需要离线图片时，免费功能已经够用。
图片 ZIP 的价值在于批量、顺序和可移植性。数量不大时，工具不应制造额外复杂度。