30 Eylül 2026 · 4 dk okuma

Typora görsellerini S3'e ya da Cloudflare R2'ye yükleme

Typora yapıştırılan görselleri varsayılan olarak Markdown dosyasının yanına kaydeder. Dokümanı yayınlayana, GitHub'a yapıştırana ya da birine gönderene kadar sorun yok: o noktada görseller bilgisayarında kalır. Görselleri yazarken kendi bucket'ına yüklemek Markdown'ı taşınabilir tutar, bağlantılar da senin kontrol ettiğin depolamayı gösterir.

aktar komutunu kur ve bağla

Typora'nın özel yükleyicisi görsel yollarıyla bir komut çalıştırır ve komutun yazdırdığı bağlantıları okur. aktar tam olarak bunu yapar ve Mac ya da Windows için Aktar'da zaten kurduğun hedefleri kullanır.

brew install getaktar/tap/aktar-cli    # or: npm install -g @getaktar/cli
  1. Aktar'da Ayarlar > Entegrasyonlar bölümünü aç, Yerel bağlantılara izin ver seçeneğini aç ve token'ı kopyala.
  2. Terminalde aktar login çalıştır ve token'ı yapıştır.
  3. aktar upload some-image.png ile dene. Bir bağlantı yazdırması gerekir.

aktar'ı Typora'nın görsel yükleyicisi yap

  1. Typora ayarlarını aç (Mac'te Typora > Settings…, Windows'ta File > Preferences…) ve Image bölümüne git.
  2. Image Uploader altında Custom Command'ı seç.
  3. Komutu tam yoluyla gir. Homebrew kullanılan bir Mac'te bu:
/opt/homebrew/bin/aktar upload

Seninkinin nerede olduğunu görmek için which aktar (Windows'ta where aktar) çalıştır. Typora terminalindeki PATH'i her zaman görmez; bu yüzden tam yol, yalnızca aktar yazmaktan daha güvenlidir.

  1. Test Uploader'a tıkla. Typora iki küçük test görseli yükler ve geri aldığı bağlantıları gösterir.

Görselleri yapıştırdığın anda otomatik yükle

Aynı Image ayarlarında When Insert… seçeneğini Upload Image yap. Bundan sonra bir dokümana görsel yapıştırmak ya da sürüklemek onu yükler ve bucket bağlantısını Markdown'a yazar.

Zaten yerel görseller içeren bir doküman için Format > Image > Upload All Local Images'ı kullan.

Görsellerin nereye gideceğini seç

Görseller varsayılan olarak Aktar'ın menü çubuğunda seçili hedefe, o hedefin yol şablonuyla adlandırılarak gider. Typora görsellerini başka bir yere göndermek için komuta seçenek ekle:

/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

Çıktıyı düz URL olarak bırak (varsayılan budur): Markdown'ı Typora kendisi yazar, bu yüzden buraya --format ya da --json ekleme.

Test Uploader başarısız olursa

  • Komut ya da node bulunamadı: which aktar çıktısındaki tam yolu kullan. Homebrew sürümü Node yolunu kendisi getirir, bu yüzden Typora'dan olduğu gibi çalışır; npm ile kurduysan /path/to/node /path/to/aktar upload şeklinde çalıştır.
  • Aktar'a bağlı değil: terminalde aktar login çalıştır ve Aktar'ın Yerel bağlantılara izin ver açıkken çalıştığından emin ol.
  • Bağlantı Access Denied ile açılıyor: yükleme başarılı, ama bucket herkese açık URL'sinde erişilebilir değil. Bkz. Access Denied hataları.

Sık sorulan sorular

Cloudflare R2, Backblaze B2 ve MinIO ile çalışır mı?

Evet. aktar, Aktar'da hangi hedef varsa oraya yükler: Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces ve MinIO dahil. Bkz. kurulum rehberleri.

PicGo'ya ya da bir eklentiye ihtiyacım var mı?

Hayır. Typora'nın yerleşik Custom Command seçeneği aktar'ı doğrudan çalıştırır.

Yüklenen görsellerin süresi dolabilir mi?

Evet, bucket'ın onları 30 gün sonra silmesi için komuta --expires 30 ekle. Yayınladığın dokümanlardaki görselleri ise genellikle saklamak istersin.