Typoraの画像をS3・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が小さなテスト画像を2枚アップロードし、返ってきたリンクを表示します。

同じ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

1行目は「Blog」という名前のアップロード先に送り、2行目はファイル名を保ったまま1つのフォルダにまとめます。出力はプレーンな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エラーをご覧ください。