30 settembre 2026 · 4 min di lettura

Come caricare le immagini di Typora su S3 o Cloudflare R2

Per impostazione predefinita, Typora salva le immagini incollate accanto al file Markdown. Va bene finché non pubblichi il documento, lo incolli su GitHub o lo invii a qualcuno: le immagini restano sul tuo computer. Caricarle sul tuo bucket mentre scrivi rende il Markdown portabile, e i link puntano a uno spazio di archiviazione che controlli tu.

Installa e collega il comando aktar

L'uploader personalizzato di Typora esegue un comando con i percorsi delle immagini e legge i link che stampa. aktar fa esattamente questo, usando le destinazioni che hai già configurato in Aktar per Mac o Windows.

brew install getaktar/tap/aktar-cli    # or: npm install -g @getaktar/cli
  1. In Aktar, apri Impostazioni > Integrazioni, attiva Consenti connessioni locali e copia il token.
  2. Esegui aktar login in un terminale e incollalo.
  3. Verifica con aktar upload some-image.png. Dovrebbe stampare un link.

Imposta aktar come uploader di immagini di Typora

  1. Apri le impostazioni di Typora (Typora > Settings… su Mac, File > Preferences… su Windows) e vai su Image.
  2. In Image Uploader, scegli Custom Command.
  3. Inserisci il comando con il percorso completo. Su un Mac con Homebrew è:
/opt/homebrew/bin/aktar upload

Esegui which aktar (su Windows, where aktar) per vedere dove si trova il tuo. Typora non sempre vede il PATH del terminale, per questo il percorso completo è più sicuro del semplice aktar.

  1. Fai clic su Test Uploader. Typora carica due piccole immagini di prova e mostra i link ricevuti.

Carica le immagini automaticamente mentre le incolli

Nelle stesse impostazioni Image, imposta When Insert… su Upload Image. Da quel momento, incollare o trascinare un'immagine in un documento la carica e scrive il link del bucket nel Markdown.

Per un documento che ha già immagini locali, usa Format > Image > Upload All Local Images.

Scegli dove vanno le immagini

Per impostazione predefinita, le immagini vanno alla destinazione selezionata nella barra dei menu di Aktar, con il nome dato dal suo modello di percorso. Per mandare le immagini di Typora altrove, aggiungi opzioni al 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

Lascia l'output come semplici URL (l'impostazione predefinita): Typora scrive il Markdown da solo, quindi qui non aggiungere --format o --json.

Se Test Uploader non riesce

  • Comando non trovato, o node non trovato: usa il percorso completo restituito da which aktar. La versione Homebrew porta con sé il percorso di Node, quindi funziona da Typora così com'è; con un'installazione npm, eseguilo come /path/to/node /path/to/aktar upload.
  • Non connesso ad Aktar: esegui aktar login in un terminale e assicurati che Aktar sia in esecuzione con Consenti connessioni locali attivo.
  • Il link si apre con Access Denied: il caricamento è riuscito, ma il bucket non è pubblico al suo URL pubblico. Vedi errori Access Denied.

Domande frequenti

Funziona con Cloudflare R2, Backblaze B2 e MinIO?

Sì. aktar carica su qualsiasi destinazione configurata in Aktar, tra cui Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces e MinIO. Vedi le guide di configurazione.

Mi servono PicGo o un plugin?

No. L'opzione Custom Command integrata in Typora esegue aktar direttamente.

Le immagini caricate possono scadere?

Sì, aggiungi --expires 30 al comando per far eliminare le immagini dal bucket dopo 30 giorni. Per le immagini nei documenti che pubblichi, di solito conviene tenerle.