最近把存在 Notion 里的一批技術筆記導出成 Markdown打算脫離平臺、放進自己的本地知識庫和靜態(tài)博客。文字導出異常順利圖片卻給我出了兩種完全不同的難題一部分剛解壓就是裂的另一部分剛導出時好好的、過一兩周卻陸續(xù)掛掉。如果不先分清這是兩類問題很容易對著一張裂圖瞎改改好一批另一批又冒出來。這篇把 Notion 導出圖片的兩種鏈接形態(tài)、各自為什么會裂以及我最后固定的遷移流程完整記下來。一、先看現(xiàn)象圖片是分兩批、以兩種姿勢掛的我這次不是所有圖一起裂而是第一批解壓完打開 .md 當場就裂編輯器里只剩占位框。第二批剛導出能正常顯示過了一段時間批量裂開而且時間越久裂的越多。這兩批的根因完全不同一個是文件沒跟著走一個是鏈接本身會過期。二、Notion 導出的圖片其實是兩種鏈接在 Notion 里選導出、格式選 Markdown會拿到一個 zip。解壓后仔細看正文里的圖片引用會發(fā)現(xiàn)它們是兩種形態(tài)。形態(tài) A本地相對路徑。圖片被下載進了導出包里的image/文件夾有的模板在同級目錄正文寫法是它能顯示完全依賴這個 .md 文件和 image 文件夾的相對位置保持不變。一旦你把 .md 單獨發(fā)到博客、把文件移動或重命名、或者刪掉了那個 image 文件夾路徑立刻失效——這就是第一批當場裂的原因。形態(tài) B遠程簽名 URL。圖片并沒有被下載到本地仍然放在 Notion 背后的對象存儲上正文是一長串這樣的地址注意 URL 里的X-Amz-Signature、X-Amz-Expires這些參數(shù)——這是對象存儲的預簽名臨時鏈接自帶授權和過期時間本來就不是設計來給人長期外鏈的。等簽名過期服務器直接返回 403圖片就裂了。這正是第二批過幾天才陸續(xù)掛的原因而且它在本地、在博客上表現(xiàn)一致跟文件位置無關。Notion 這么做是為了在導出包盡量離線完整和包體積別太大之間折中一部分圖打包進本地大量歷史圖片走遠程簽名。三、三步確認你手里是哪一種、還能不能救別急著傳圖先花兩分鐘定性解壓看目錄有沒有image/文件夾、里面大概多少張圖心里有個數(shù)。把圖片鏈接全部抽出來分類。用正則!\[.*?\]\(([^)])\)把所有圖片引用抓出來看路徑是image/開頭的相對路徑還是https://開頭、且?guī)-Amz-Signature之類簽名參數(shù)的遠程鏈接。命令行里一條 grep 就能粗分# 遠程簽名鏈接grep-Eo\]\(https://[^)]*X-Amz[^)]*\)*.md# 本地相對路徑grep-Eo\]\(image/[^)]*\)*.md對遠程簽名鏈接探一下狀態(tài)curl -I 那條長URL返回 200 說明還在有效期、還能抓返回 403 就是過期了。簽名鏈接要趁沒過期盡快處理拖得越久能救回的越少。四、四種處理思路怎么取舍思路適合場景主要問題保留相對路徑image 文件夾跟著 .md 走純本地、離線歸檔一發(fā)博客、換位置就裂多設備難同步手動一張張重新上傳只有三五張圖幾十上百張時純體力活還容易漏自建對象存儲 CDN想完全自己掌控要配 bucket、權限、分發(fā)和域名費精力統(tǒng)一轉到一個穩(wěn)定外鏈圖源正文只存 URL要發(fā)博客、多設備、長期維護需要挑一個能長期用、支持批量遷移的服務我更傾向最后一種讓圖片源和文檔徹底脫鉤。正文里只存一個穩(wěn)定 URL以后不管換筆記軟件、發(fā)博客還是換電腦文檔里的鏈接都不用動從根上避免一遷移就裂圖。五、我固定下來的遷移流程思路定了操作上把本地圖和簽名圖分開處理先備份原始導出包整個 zip 原樣留一份后續(xù)都在副本上動。抽鏈接、去重、分成兩堆相對路徑一堆、遠程簽名一堆。本地 image 圖整批上傳在圖床網(wǎng)頁端把 image 文件夾里的圖多選、拖拽一次傳上去頁面也支持直接 CmdV 粘貼拿回 Markdown 鏈接。遠程簽名圖趁有效期批量轉存把那批長 URL 交給按 URL 批量上傳由服務端逐條抓取轉存最后拿到一張舊鏈接到新鏈接的映射表不用自己一張張下載再傳。用多級目錄加隨機路徑存放筆記里大量截圖都重名image.png、截屏 2024-xx.png隨機路徑能避免它們扎堆在同一目錄、因同名互相覆蓋。按映射表精確替換寫回 .md用腳本按完整舊鏈接匹配替換而不是簡單替換文件名替換條數(shù)逐條核對避免誤傷順手處理文件名里的空格在 URL 里是%20和中文編碼。無痕窗口驗證新老筆記各開幾篇確認圖都在再全文搜索X-Amz和](image/的殘留都應為 0。這套流程我自己是放在圖床小鎮(zhèn)上做的主要是圖省事網(wǎng)頁多選拖拽、按 URL 批量抓取轉存、多級隨機路徑和同名覆蓋這幾件事它都能直接處理不用我再去搭對象存儲和分發(fā)。當然這純屬個人選擇愿意自己維護的話自建對象存儲再套一層 CDN 是等價甚至更可控的方案按自己精力來就行沒必要照搬。六、遷移后自檢清單原始導出 zip 已備份改動都在副本上相對路徑圖、遠程簽名圖兩類都已處理無遺漏全文搜X-Amz為 0簽名鏈接已清干凈全文搜](image/為 0相對路徑已清干凈文件名空格、中文編碼正常沒有二次裂圖無痕窗口打開新老筆記各幾篇圖片可見舊到新映射表留存萬一替換錯了能回滾Notion 導出圖片的坑說穿了還是圖片源和文檔綁在一起、或者鏈接是臨時的。把圖片統(tǒng)一到一個穩(wěn)定圖源、正文只留 URL以后文檔搬到哪里都不用再動圖。這個圖片源獨立的思路和我之前整理靜態(tài)博客遷移、Obsidian 圖片管理時是一脈相承的感興趣可以對照看Hexo 換到 Hugo 又換了電腦博客圖片為什么連環(huán)裂、Obsidian 圖片別再塞進 vault。官網(wǎng)https://imgbed.cn