30. September 2026 · 4 Min. Lesezeit

So lädst du Typora-Bilder automatisch zu S3 oder Cloudflare R2 hoch

Q: Können hochgeladene Bilder ablaufen?

Ja, ergänze den Befehl um --expires 30, dann löscht der Bucket sie nach 30 Tagen. Bilder in Dokumenten, die du veröffentlichst, willst du aber meist behalten.

Typora speichert eingefügte Bilder standardmäßig neben deiner Markdown-Datei. Das passt, bis du das Dokument veröffentlichst, es in GitHub einfügst oder jemandem schickst: Die Bilder bleiben auf deinem Computer zurück. Wenn du sie schon beim Schreiben in deinen eigenen Bucket hochlädst, bleibt das Markdown portabel, und die Links zeigen auf Speicher, den du selbst kontrollierst.

Den Befehl aktar installieren und verbinden

Der Custom Uploader von Typora führt einen Befehl mit den Bildpfaden aus und liest die Links, die er ausgibt. Genau das macht aktar, mit den Zielen, die du in Aktar für Mac oder Windows schon eingerichtet hast.

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

Öffne in Aktar Einstellungen → Integrationen, aktiviere Lokale Verbindungen erlauben und kopiere das Token.
Führe in einem Terminal aktar login aus und füge es ein.
Prüf es mit aktar upload some-image.png. Der Befehl sollte einen Link ausgeben.

aktar als Bild-Uploader in Typora einrichten

Öffne die Einstellungen von Typora (Typora > Settings… auf dem Mac, File > Preferences… unter Windows) und geh zu Image.
Wähle unter Image Uploader die Option Custom Command.
Gib den Befehl mit vollständigem Pfad ein. Auf einem Mac mit Homebrew ist das:

/opt/homebrew/bin/aktar upload

Mit which aktar (unter Windows where aktar) siehst du, wo deiner liegt. Typora sieht nicht immer den PATH deines Terminals, deshalb ist der vollständige Pfad sicherer als nur aktar.

Klick auf Test Uploader. Typora lädt zwei kleine Testbilder hoch und zeigt die Links, die zurückkamen.

Bilder beim Einfügen automatisch hochladen

Setz in denselben Image-Einstellungen When Insert… auf Upload Image. Ab dann wird jedes Bild, das du in ein Dokument einfügst oder ziehst, hochgeladen und der Bucket-Link ins Markdown geschrieben.

Für ein Dokument, das schon lokale Bilder enthält, nutzt du Format > Image > Upload All Local Images.

Festlegen, wohin die Bilder gehen

Standardmäßig gehen Bilder an das Ziel, das in der Menüleiste von Aktar ausgewählt ist, und werden nach dessen Pfadvorlage benannt. Um Typora-Bilder woandershin zu schicken, ergänzt du den Befehl um Optionen:

/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

Lass die Ausgabe bei einfachen URLs (der Standard): Typora schreibt das Markdown selbst, füge hier also kein --format oder --json hinzu.

Wenn Test Uploader fehlschlägt

Befehl oder node nicht gefunden: Nutze den vollständigen Pfad aus which aktar. Die Homebrew-Version bringt ihren eigenen Pfad zu Node mit und funktioniert daher so, wie sie ist, aus Typora heraus. Bei einer npm-Installation führst du sie als /path/to/node /path/to/aktar upload aus.
Keine Verbindung zu Aktar: Führe aktar login in einem Terminal aus und stell sicher, dass Aktar läuft und Lokale Verbindungen erlauben aktiviert ist.
Der Link zeigt Access Denied: Der Upload hat geklappt, aber der Bucket ist unter seiner öffentlichen URL nicht öffentlich. Siehe Access-Denied-Fehler.

Häufige Fragen

Funktioniert das mit Cloudflare R2, Backblaze B2 und MinIO?

Ja. aktar lädt zu jedem Ziel hoch, das in Aktar eingerichtet ist, darunter Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces und MinIO. Siehe die Einrichtungsanleitungen.

Brauche ich PicGo oder ein Plugin?

Nein. Die eingebaute Option Custom Command in Typora führt aktar direkt aus.

Können hochgeladene Bilder ablaufen?

Ja, ergänze den Befehl um --expires 30, dann löscht der Bucket sie nach 30 Tagen. Bilder in Dokumenten, die du veröffentlichst, willst du aber meist behalten.