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
- In Aktar, apri Impostazioni > Integrazioni, attiva Consenti connessioni locali e copia il token.
- Esegui
aktar loginin un terminale e incollalo. - Verifica con
aktar upload some-image.png. Dovrebbe stampare un link.
Imposta aktar come uploader di immagini di Typora
- Apri le impostazioni di Typora (Typora > Settings… su Mac, File > Preferences… su Windows) e vai su Image.
- In Image Uploader, scegli Custom Command.
- 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.
- 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 loginin 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.
Oppure lascia fare ad Aktar
Aktar conserva le chiavi del tuo spazio di archiviazione e si occupa del caricamento, mentre aktar si limita a passargli le immagini, quindi Typora non ha mai bisogno delle tue chiavi. Lo stesso bucket funziona dalla barra dei menu, dalla scorciatoia globale, da Raycast e dal telefono, e ogni immagine compare nella cronologia di Aktar.
Domande frequenti
Funziona con Cloudflare R2, Backblaze B2 e MinIO?
Mi servono PicGo o un plugin?
Le immagini caricate possono scadere?
--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.