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