最近把存在 Notion 里的一批技术笔记导出成 Markdown打算脱离平台、放进自己的本地知识库和静态博客。文字导出异常顺利图片却给我出了两种完全不同的难题一部分刚解压就是裂的另一部分刚导出时好好的、过一两周却陆续挂掉。如果不先分清这是两类问题很容易对着一张裂图瞎改改好一批另一批又冒出来。这篇把 Notion 导出图片的两种链接形态、各自为什么会裂以及我最后固定的迁移流程完整记下来。一、先看现象图片是分两批、以两种姿势挂的我这次不是所有图一起裂而是第一批解压完打开 .md 当场就裂编辑器里只剩占位框。第二批刚导出能正常显示过了一段时间批量裂开而且时间越久裂的越多。这两批的根因完全不同一个是文件没跟着走一个是链接本身会过期。二、Notion 导出的图片其实是两种链接在 Notion 里选导出、格式选 Markdown会拿到一个 zip。解压后仔细看正文里的图片引用会发现它们是两种形态。形态 A本地相对路径。图片被下载进了导出包里的image/文件夹有的模板在同级目录正文写法是它能显示完全依赖这个 .md 文件和 image 文件夹的相对位置保持不变。一旦你把 .md 单独发到博客、把文件移动或重命名、或者删掉了那个 image 文件夹路径立刻失效——这就是第一批当场裂的原因。形态 B远程签名 URL。图片并没有被下载到本地仍然放在 Notion 背后的对象存储上正文是一长串这样的地址注意 URL 里的X-Amz-Signature、X-Amz-Expires这些参数——这是对象存储的预签名临时链接自带授权和过期时间本来就不是设计来给人长期外链的。等签名过期服务器直接返回 403图片就裂了。这正是第二批过几天才陆续挂的原因而且它在本地、在博客上表现一致跟文件位置无关。Notion 这么做是为了在导出包尽量离线完整和包体积别太大之间折中一部分图打包进本地大量历史图片走远程签名。三、三步确认你手里是哪一种、还能不能救别急着传图先花两分钟定性解压看目录有没有image/文件夹、里面大概多少张图心里有个数。把图片链接全部抽出来分类。用正则!\[.*?\]\(([^)])\)把所有图片引用抓出来看路径是image/开头的相对路径还是https://开头、且带X-Amz-Signature之类签名参数的远程链接。命令行里一条 grep 就能粗分# 远程签名链接grep-Eo\]\(https://[^)]*X-Amz[^)]*\)*.md# 本地相对路径grep-Eo\]\(image/[^)]*\)*.md对远程签名链接探一下状态curl -I 那条长URL返回 200 说明还在有效期、还能抓返回 403 就是过期了。签名链接要趁没过期尽快处理拖得越久能救回的越少。四、四种处理思路怎么取舍思路适合场景主要问题保留相对路径image 文件夹跟着 .md 走纯本地、离线归档一发博客、换位置就裂多设备难同步手动一张张重新上传只有三五张图几十上百张时纯体力活还容易漏自建对象存储 CDN想完全自己掌控要配 bucket、权限、分发和域名费精力统一转到一个稳定外链图源正文只存 URL要发博客、多设备、长期维护需要挑一个能长期用、支持批量迁移的服务我更倾向最后一种让图片源和文档彻底脱钩。正文里只存一个稳定 URL以后不管换笔记软件、发博客还是换电脑文档里的链接都不用动从根上避免一迁移就裂图。五、我固定下来的迁移流程思路定了操作上把本地图和签名图分开处理先备份原始导出包整个 zip 原样留一份后续都在副本上动。抽链接、去重、分成两堆相对路径一堆、远程签名一堆。本地 image 图整批上传在图床网页端把 image 文件夹里的图多选、拖拽一次传上去页面也支持直接 CmdV 粘贴拿回 Markdown 链接。远程签名图趁有效期批量转存把那批长 URL 交给按 URL 批量上传由服务端逐条抓取转存最后拿到一张旧链接到新链接的映射表不用自己一张张下载再传。用多级目录加随机路径存放笔记里大量截图都重名image.png、截屏 2024-xx.png随机路径能避免它们扎堆在同一目录、因同名互相覆盖。按映射表精确替换写回 .md用脚本按完整旧链接匹配替换而不是简单替换文件名替换条数逐条核对避免误伤顺手处理文件名里的空格在 URL 里是%20和中文编码。无痕窗口验证新老笔记各开几篇确认图都在再全文搜索X-Amz和](image/的残留都应为 0。这套流程我自己是放在图床小镇上做的主要是图省事网页多选拖拽、按 URL 批量抓取转存、多级随机路径和同名覆盖这几件事它都能直接处理不用我再去搭对象存储和分发。当然这纯属个人选择愿意自己维护的话自建对象存储再套一层 CDN 是等价甚至更可控的方案按自己精力来就行没必要照搬。六、迁移后自检清单原始导出 zip 已备份改动都在副本上相对路径图、远程签名图两类都已处理无遗漏全文搜X-Amz为 0签名链接已清干净全文搜](image/为 0相对路径已清干净文件名空格、中文编码正常没有二次裂图无痕窗口打开新老笔记各几篇图片可见旧到新映射表留存万一替换错了能回滚Notion 导出图片的坑说穿了还是图片源和文档绑在一起、或者链接是临时的。把图片统一到一个稳定图源、正文只留 URL以后文档搬到哪里都不用再动图。这个图片源独立的思路和我之前整理静态博客迁移、Obsidian 图片管理时是一脉相承的感兴趣可以对照看Hexo 换到 Hugo 又换了电脑博客图片为什么连环裂、Obsidian 图片别再塞进 vault。官网https://imgbed.cn