图片裂图通常不是 Markdown 编辑器的问题，而是文件仍在请求飞书的临时链接、账号权限或公司网络。把图片下载到本地并改成相对路径，再断网和移动目录测试，才能确认导出文件真正可移植。
Markdown 正文正常，图片全是破图标时，编辑器通常没问题。文件里保存的仍然是飞书在线图片，只是链接当前看起来还能用。
临时链接会过期，图片也可能依赖你的账号或公司网络。先找出图片卡在哪一环，再决定是改路径、跑脚本，还是从导出环节解决。
图片失效的三个环节
一，链接本身有时效
部分复制或导出方式生成的图片地址带有临时签名。链接在几个小时或一段时间内有效，过期后即使文件位置没变，也会返回错误。
这类问题的特征是：刚导出时正常，放一段时间后开始批量失效。
二，权限绑定当前账号
有些图片地址要求浏览器里存在有效的飞书登录态。换了账号、退出组织或把文件发给别人后，图片请求就可能被拒绝。
这类问题的特征是：只有登录账号能看，未登录或换电脑后裂图。
三，图片依赖原组织的网络
企业内部文档可能只有内网、白名单或特定网络环境能访问。你已经把 Markdown 下载到了本地，但图片仍然通过网络请求原地址，所以离开公司网络后就会失败。
先做一个 30 秒自查
把 Markdown 和图片目录一起复制到新的文件夹，然后：
- 断开网络或换一台没有登录飞书的设备。
- 打开任意一篇 Markdown。
- 检查图片、表格和代码块是否完整。
- 移动整个目录后再次打开，确认图片路径没有变成绝对路径。
断网后图片消失，说明你只保存了一份指向在线图片的清单。
三种修复方式
手动另存再改路径
右键保存图片，放进 assets 文件夹，再逐条修改 Markdown 路径。几张图片没问题，几百张会非常耗时间，而且容易漏图。
用脚本批量下载
脚本可以抓取图片并替换链接，但需要处理登录、防盗链和文件名冲突。它适合有开发能力的人做一次性迁移，不适合普通用户日常使用。
在导出时就让图片落本地
最省事的做法是把图片下载放回导出流程。导出的 Markdown 使用相对路径引用同目录图片，整个文件夹移动或断网后仍能打开。
飞书工具箱的 Markdown 和图片 ZIP 会把文档与图片放在同一个压缩包里；免费版可以处理 Markdown，图片打包属于 Pro，可先试用。
怎样判断一份 Markdown 是否可移植
只要满足下面三条，基本可以放心长期保存：
- 图片实际存在于本地目录，而不是只写了一个飞书链接。
- 使用相对路径，移动整个文件夹后仍然显示。
- 断网打开时，正文、表格、代码块和图片都正常。
如果缺少其中一条，把文件放进笔记软件也只是暂时可用，后续仍然会断链。
哪些图片不适合下载
只保存你有权访问和保存的内容。涉及客户隐私、公司机密或明确禁止外发的图片，不要因为工具支持批量下载就改变原来的权限边界。
另外，扫描件、超大原图和视频附件不适合全部内联进 Markdown。它们更适合单独放进资源目录，并在正文中保留一个清晰的文件名和位置说明。
文本已经下载，图片还在服务器上，这就是裂图的根因。图片和正文一起移动后仍能打开，导出才算完整。