Como fazer upload de imagens do Typora para o S3 ou Cloudflare R2

O uploader personalizado do Typora executa um comando com os caminhos das imagens e lê os links que ele mostra. O aktar faz exatamente isso, usando os destinos que você já configurou no Aktar para Mac ou Windows.

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

1. No Aktar, abra Ajustes > Integrações, ative Permitir conexões locais e copie o token.
2. Execute aktar login em um terminal e cole o token.
3. Teste com aktar upload some-image.png. Ele deve mostrar um link.

1. Abra as configurações do Typora (Typora > Settings… no Mac, File > Preferences… no Windows) e vá até Image.
2. Em Image Uploader, escolha Custom Command.
3. Digite o comando com o caminho completo. Em um Mac com Homebrew, fica assim:

/opt/homebrew/bin/aktar upload

Execute which aktar (no Windows, where aktar) para ver onde o seu está. O Typora nem sempre enxerga o PATH do seu terminal, por isso o caminho completo é mais seguro do que só aktar.

4. Clique em Test Uploader. O Typora envia duas pequenas imagens de teste e mostra os links que recebeu.

Nas mesmas configurações de Image, defina When Insert… como Upload Image. A partir daí, colar ou arrastar uma imagem para um documento faz o envio e escreve o link do bucket no Markdown.

Para um documento que já tem imagens locais, use Format > Image > Upload All Local Images.

Por padrão, as imagens vão para o destino selecionado na barra de menus do Aktar, com o nome definido pelo modelo de caminho dele. Para mandar as imagens do Typora para outro lugar, adicione opções ao comando:

/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

Mantenha a saída como URLs simples (o padrão): o próprio Typora escreve o Markdown, então não adicione --format nem --json aqui.

• Comando não encontrado, ou node não encontrado: use o caminho completo que which aktar mostra. A versão do Homebrew já traz o próprio caminho para o Node, então funciona no Typora do jeito que está; com uma instalação pelo npm, execute como /path/to/node /path/to/aktar upload.
• Não conectado ao Aktar: execute aktar login em um terminal e confira se o Aktar está aberto com Permitir conexões locais ativado.
• O link abre com Access Denied: o envio funcionou, mas o bucket não está público na URL pública dele. Veja erros de Access Denied.