Comment envoyer automatiquement vos images Typora sur S3 ou Cloudflare R2

L'outil d'envoi personnalisé de Typora lance une commande avec les chemins des images et lit les liens qu'elle affiche. C'est exactement ce que fait aktar, avec les destinations que vous avez déjà configurées dans Aktar pour Mac ou Windows.

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

1. Dans Aktar, ouvrez Réglages > Intégrations, activez Autoriser les connexions locales et copiez le jeton.
2. Lancez aktar login dans un terminal et collez-le.
3. Vérifiez avec aktar upload some-image.png. La commande doit afficher un lien.

1. Ouvrez les réglages de Typora (Typora > Settings… sur Mac, File > Preferences… sous Windows) et allez dans Image.
2. Sous Image Uploader, choisissez Custom Command.
3. Saisissez la commande avec son chemin complet. Sur un Mac avec Homebrew, cela donne :

/opt/homebrew/bin/aktar upload

Lancez which aktar (sous Windows, where aktar) pour savoir où se trouve la vôtre. Typora ne voit pas toujours le PATH de votre terminal : le chemin complet est donc plus sûr que aktar seul.

4. Cliquez sur Test Uploader. Typora envoie deux petites images de test et affiche les liens obtenus.

Dans les mêmes réglages Image, réglez When Insert… sur Upload Image. Dès lors, coller ou glisser une image dans un document l'envoie et écrit le lien du bucket dans le Markdown.

Pour un document qui contient déjà des images locales, utilisez Format > Image > Upload All Local Images.

Par défaut, les images vont vers la destination sélectionnée dans la barre des menus d'Aktar, nommées selon son modèle de chemin. Pour envoyer les images Typora ailleurs, ajoutez des options à la commande :

/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

Gardez une sortie en URL simples (le comportement par défaut) : Typora écrit lui-même le Markdown, n'ajoutez donc ni --format ni --json ici.

• Commande introuvable, ou node introuvable : utilisez le chemin complet donné par which aktar. La version Homebrew embarque son propre chemin vers Node et fonctionne donc telle quelle depuis Typora ; avec une installation npm, lancez-la sous la forme /path/to/node /path/to/aktar upload.
• Pas de connexion à Aktar : lancez aktar login dans un terminal, et vérifiez qu'Aktar est ouvert avec Autoriser les connexions locales activé.
• Le lien affiche Access Denied : l'envoi a réussi, mais le bucket n'est pas public à son URL publique. Voir les erreurs Access Denied.