30 September 2026 · 4 menit membaca
Cara mengunggah gambar Typora ke S3 atau Cloudflare R2
Secara default, Typora menyimpan gambar yang ditempel di samping file Markdown Anda. Itu tidak masalah sampai Anda menerbitkan dokumen, menempelkannya ke GitHub, atau mengirimkannya ke seseorang: gambarnya tertinggal di komputer Anda. Mengunggahnya ke bucket sendiri sambil menulis membuat Markdown tetap portabel, dan tautannya mengarah ke penyimpanan yang Anda kendalikan.
Instal dan hubungkan perintah aktar
Pengunggah kustom Typora menjalankan sebuah perintah dengan path gambar dan membaca tautan yang dicetaknya. aktar melakukan persis hal itu, dengan tujuan yang sudah Anda siapkan di Aktar untuk Mac atau Windows.
brew install getaktar/tap/aktar-cli # or: npm install -g @getaktar/cli
- Di Aktar, buka Pengaturan > Integrasi, nyalakan Izinkan koneksi lokal, dan salin tokennya.
- Jalankan
aktar logindi terminal dan tempel token tersebut. - Periksa dengan
aktar upload some-image.png. Perintah ini seharusnya mencetak sebuah tautan.
Jadikan aktar sebagai pengunggah gambar Typora
- Buka pengaturan Typora (Typora > Settings… di Mac, File > Preferences… di Windows) dan masuk ke Image.
- Di bagian Image Uploader, pilih Custom Command.
- Masukkan perintah beserta path lengkapnya. Di Mac dengan Homebrew, perintahnya:
/opt/homebrew/bin/aktar upload
Jalankan which aktar (di Windows, where aktar) untuk melihat lokasinya di komputer Anda. Typora tidak selalu membaca PATH terminal Anda, karena itu path lengkap lebih aman daripada sekadar aktar.
- Klik Test Uploader. Typora mengunggah dua gambar uji kecil dan menampilkan tautan yang diterimanya.
Unggah gambar otomatis saat Anda menempelkannya
Di pengaturan Image yang sama, atur When Insert… ke Upload Image. Sejak saat itu, menempel atau menyeret gambar ke dokumen akan mengunggahnya dan menulis tautan bucket ke dalam Markdown.
Untuk dokumen yang sudah berisi gambar lokal, gunakan Format > Image > Upload All Local Images.
Pilih ke mana gambar dikirim
Secara default, gambar dikirim ke tujuan yang dipilih di bar menu Aktar, dan diberi nama sesuai template jalurnya. Untuk mengirim gambar Typora ke tempat lain, tambahkan opsi ke perintahnya:
/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
Biarkan output berupa URL biasa (default): Typora menulis Markdown-nya sendiri, jadi jangan tambahkan --format atau --json di sini.
Jika Test Uploader gagal
- Perintah atau node tidak ditemukan: gunakan path lengkap dari
which aktar. Versi Homebrew membawa path ke Node-nya sendiri, jadi langsung berfungsi dari Typora; untuk instalasi npm, jalankan sebagai/path/to/node /path/to/aktar upload. - Tidak terhubung ke Aktar: jalankan
aktar logindi terminal, dan pastikan Aktar sedang berjalan dengan Izinkan koneksi lokal dalam keadaan menyala. - Tautan terbuka dengan Access Denied: unggahan berhasil, tetapi bucket tidak publik di URL publiknya. Lihat error Access Denied.
Pertanyaan umum
Apakah ini bisa dipakai dengan Cloudflare R2, Backblaze B2 dan MinIO?
Bisa. aktar mengunggah ke tujuan apa pun yang ada di Aktar, termasuk Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, dan MinIO. Lihat panduan penyiapan.
Apakah saya perlu PicGo atau plugin?
Tidak. Opsi Custom Command bawaan Typora menjalankan aktar secara langsung.
Bisakah gambar yang diunggah kedaluwarsa?
Bisa, tambahkan --expires 30 ke perintah agar bucket menghapusnya setelah 30 hari. Untuk gambar di dokumen yang Anda terbitkan, biasanya Anda ingin menyimpannya.