How to upload Typora images to S3 or Cloudflare R2

Typora's custom uploader runs a command with the image paths and reads the links it prints. aktar does exactly that, using the destinations you already set up in Aktar for Mac or Windows.

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

1. In Aktar, open Settings > Integrations, turn on Allow local connections and copy the token.
2. Run aktar login in a terminal and paste it.
3. Check it with aktar upload some-image.png. It should print a link.

1. Open Typora's settings (Typora > Settings… on a Mac, File > Preferences… on Windows) and go to Image.
2. Under Image Uploader, choose Custom Command.
3. Enter the command with its full path. On a Mac with Homebrew that's:

/opt/homebrew/bin/aktar upload

Run which aktar (on Windows, where aktar) to see where yours is. Typora doesn't always see your terminal's PATH, which is why the full path is safer than just aktar.

4. Click Test Uploader. Typora uploads two small test images and shows the links it got back.

In the same Image settings, set When Insert… to Upload Image. From then on, pasting or dragging an image into a document uploads it and writes the bucket link into the Markdown.

For a document that already has local images, use Format > Image > Upload All Local Images.

By default, images go to the destination selected in Aktar's menu bar, named with its path template. To send Typora images somewhere else, add options to the command:

/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

Keep the output as plain URLs (the default): Typora writes the Markdown itself, so don't add --format or --json here.

• Command not found, or node not found: use the full path from which aktar. The Homebrew version brings its own path to Node, so it works from Typora as is; with an npm install, run it as /path/to/node /path/to/aktar upload.
• Not connected to Aktar: run aktar login in a terminal, and make sure Aktar is running with Allow local connections on.
• The link opens with Access Denied: the upload worked, but the bucket isn't public at its public URL. See Access Denied errors.