Как загружать изображения из Typora в S3 или Cloudflare R2

Собственный загрузчик Typora запускает команду с путями к изображениям и считывает выведенные ею ссылки. aktar делает именно это, используя места назначения, которые вы уже настроили в Aktar для Mac или Windows.

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 (Typora > Settings… на Mac, File > Preferences… в Windows) и перейдите в раздел Image.
2. В пункте Image Uploader выберите Custom Command.
3. Введите команду с полным путем. На Mac с Homebrew это:

/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 (по умолчанию): Typora сама формирует Markdown, поэтому не добавляйте здесь --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.