如何把 Typora 圖片上傳到 S3 或 Cloudflare R2

Typora 的自訂上傳工具會帶著圖片路徑執行一個指令，並讀取它印出的連結。aktar 正是這樣運作，使用你在 Mac 或 Windows 版 Aktar 中已經設定好的目的地。

brew install getaktar/tap/aktar-cli    # or: npm install -g @getaktar/cli

1. 在 Aktar 中開啟設定 > 整合，開啟允許本機連線並拷貝權杖。
2. 在終端機中執行 aktar login 並貼上權杖。
3. 用 aktar upload some-image.png 測試一下，應該會印出一個連結。

1. 開啟 Typora 的設定（Mac 上是 Typora > Settings…，Windows 上是 File > Preferences…），前往 Image（影像）。
2. 在 Image Uploader（圖片上傳工具）中選擇 Custom Command（自訂指令）。
3. 輸入包含完整路徑的指令。在用 Homebrew 安裝的 Mac 上是：

/opt/homebrew/bin/aktar upload

執行 which aktar（Windows 上是 where aktar）查看你的路徑。Typora 不一定讀得到終端機的 PATH，所以使用完整路徑比只寫 aktar 更保險。

4. 按一下 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。

• 找不到指令，或找不到 node：請使用 which aktar 顯示的完整路徑。Homebrew 版本會自帶 Node 的路徑，所以在 Typora 中可以直接使用；如果是用 npm 安裝的，請以 /path/to/node /path/to/aktar upload 的形式執行。
• 沒有連接到 Aktar：在終端機中執行 aktar login，並確認 Aktar 正在執行且已開啟「允許本機連線」。
• 開啟連結時出現 Access Denied：上傳已經成功，但儲存貯體在它的公開 URL 上並非公開。請參考 Access Denied 錯誤。