Typora 預設會把貼上的圖片存在 Markdown 檔案旁邊。這樣用沒問題,直到你要發布文件、貼到 GitHub 或傳給別人時,圖片卻還留在你的電腦裡。邊寫邊把圖片上傳到自己的儲存貯體,Markdown 就能隨處使用,連結也會指向你掌控的儲存空間。
安裝並連接 aktar 指令
Typora 的自訂上傳工具會帶著圖片路徑執行一個指令,並讀取它印出的連結。aktar 正是這樣運作,使用你在 Mac 或 Windows 版 Aktar 中已經設定好的目的地。
brew install getaktar/tap/aktar-cli # or: npm install -g @getaktar/cli
- 在 Aktar 中開啟設定 > 整合,開啟允許本機連線並拷貝權杖。
- 在終端機中執行
aktar login並貼上權杖。 - 用
aktar upload some-image.png測試一下,應該會印出一個連結。
把 aktar 設為 Typora 的圖片上傳工具
- 開啟 Typora 的設定(Mac 上是 Typora > Settings…,Windows 上是 File > Preferences…),前往 Image(影像)。
- 在 Image Uploader(圖片上傳工具)中選擇 Custom Command(自訂指令)。
- 輸入包含完整路徑的指令。在用 Homebrew 安裝的 Mac 上是:
/opt/homebrew/bin/aktar upload
執行 which aktar(Windows 上是 where aktar)查看你的路徑。Typora 不一定讀得到終端機的 PATH,所以使用完整路徑比只寫 aktar 更保險。
- 按一下 Test Uploader。Typora 會上傳兩張小的測試圖片,並顯示取回的連結。
貼上圖片時自動上傳
在同一個 Image 設定中,把 When Insert…(插入圖片時)設為 Upload Image。從此以後,在文件中貼上或拖入圖片,就會自動上傳,並把儲存貯體的連結寫進 Markdown。
如果文件裡已經有本機圖片,請使用 Format > Image > Upload All Local Images。
選擇圖片要放在哪裡
圖片預設會送到 Aktar 選單列中選取的目的地,並依它的路徑範本命名。如果想把 Typora 的圖片送到別處,請在指令中加入選項:
/opt/homebrew/bin/aktar upload -d Blog # a destination named "Blog"
/opt/homebrew/bin/aktar upload --folder docs/images # keep file names, in one folder
輸出請保持為純 URL(預設值):Markdown 由 Typora 自己撰寫,所以這裡不要加上 --format 或 --json。
如果 Test Uploader 失敗
- 找不到指令,或找不到 node:請使用
which aktar顯示的完整路徑。Homebrew 版本會自帶 Node 的路徑,所以在 Typora 中可以直接使用;如果是用 npm 安裝的,請以/path/to/node /path/to/aktar upload的形式執行。 - 沒有連接到 Aktar:在終端機中執行
aktar login,並確認 Aktar 正在執行且已開啟「允許本機連線」。 - 開啟連結時出現 Access Denied:上傳已經成功,但儲存貯體在它的公開 URL 上並非公開。請參考 Access Denied 錯誤。
或者交給 Aktar 處理
Aktar 保管你的儲存空間金鑰並負責上傳,aktar 只是把圖片交給它,所以 Typora 永遠不需要你的金鑰。同一個儲存貯體也能從選單列、全域快速鍵、Raycast 和你的手機使用,而且每張圖片都會出現在 Aktar 的歷史記錄中。
常見問題
這也適用於 Cloudflare R2、Backblaze B2 和 MinIO 嗎?
需要 PicGo 或外掛程式嗎?
上傳的圖片可以設定到期嗎?
--expires 30,儲存貯體就會在 30 天後刪除它們。不過如果是要發布的文件中的圖片,通常還是會想保留。