Markdown'ı PDF'e Çevirme (Kod Blokları ve Tablolar Bozulmadan)

Markdown'ı şık bir PDF'e çevirin — README'ler, notlar ve dokümanlar; kod blokları ve tablolar düzgün işlenir. Tarayıcıda ücretsiz, kayıt yok.

Markdown dosyasının biçimli bir PDF'e dönüştürülmesi — Düz .md girer → dizgili PDF çıkar

Markdown, işlerin yazıldığı yerdir — README'ler, toplantı notları, spesifikasyonlar, dokümantasyon. PDF ise işlerin gönderildiği yer: .md dosyası açmayacak bir müşteriye, ek isteyen bir yöneticiye, bir yazıcıya. İkisi arasındaki boşluk tek bir dönüşümdür ve onu aşmak için pandoc ve bir LaTeX dağıtımı kurmak zorunda olmamalısınız.

Çoğu hızlı yolun pürüzü, teknik belgelerin dayandığı kısımları tam da bozmalarıdır: kod blokları orantılı yazıya çöker, boru tabloları | karakterlerinden bir duvar olarak basılır ve iç içe listeler yassılaşır. Bir dönüştürücü burada ancak kod ve tablolar sağ kalırsa işe yarar — bu rehberin her şeyi tuttuğu çıta da budur.

Çevirme — adım adım

Aracı açın

pdfty.com/tools/markdown-to-pdf adresine gidin. 20 MB'a kadar ücretsiz — ve 20 MB'lık bir Markdown dosyası roman olurdu; fiilen sınırsız.

.md dosyanızı bırakın

.md ve .markdown dosyaları kabul edilir. Dosya HTTPS üzerinden yüklenir ve 1 saat sonra silinir.

Dönüşüm otomatik çalışır

Markdown ayrıştırılır (tablolar, çitli kod ve sözdizimi vurgusu dahil) ve temiz, yerleşik bir stil sayfasıyla dizilir. Birkaç saniye.

PDF'i indirin

Düzgün başlıklı, kod bloklu, tablolu ve sayfa sonlu tek bir PDF.

Gözden geçirin

Düzenleyicinizin özel işlemesine dayanan bir şey var mı diye tarayın — aşağıdaki tuzaklara bakın.

pdfty Markdown'dan PDF'e aracı — Bir .md yükleyin, dizgili bir PDF indirin — pandoc yok, LaTeX yok

Tam olarak ne işlenir

Dönüştürücü, standart Markdown'ı artı teknik yazım için önemli uzantıları destekler:

Başlıklar — boyut hiyerarşisi, H1 ve H2 altında ince çizgiler
Çitli kod blokları — eş aralıklı, açık gri arka plan, korunan girinti, yaygın diller için sözdizimi vurgusu
Satır içi kod — tanıdık gri çip stili
Tablolar — GitHub tarzı boru tabloları, gölgeli başlık satırlı çerçeveli tablolara dönüşür
Alıntılar — sol kenarlık, soluk metin
Listeler — sıralı, sırasız, iç içe
Bağlantılar — PDF'te tıklanabilir bağlantı olarak kalır
URL'li görseller — ![](https://…) görselleri çekilip gömülür

Sayfa, rahat bir okuma genişliğinde cömert kenar boşluklarıyla dizilir — ham tarayıcı çıktısından çok "bitmiş görünen dahili doküman"a yakındır.

Ne İŞLENMEZ

Dürüstlük bölümü. Markdown'ın lehçeleri var ve bu araç standart Markdown + tablolar + çitli kodu uygular, tam GitHub lezzetini değil:

Görev listeleri (- [ ] yapılacak) onay kutusu değil, düz köşeli parantez olarak basılır.
Üstü çizili (~~metin~~) dönüştürülmez — tildeler kalır.
Yerel görseller (![](./diagrams/arch.png)) görünemez: tek dosya yüklersiniz ve sunucunun diskinizde yanında duran dosyalara erişimi yoktur. Görseli bir URL'de barındırın ya da boşluğa hazır olun.
Mermaid / matematik blokları diyagram ya da denklem değil, düz kod bloğu olarak işlenir.
Özel tema yok — tek yerleşik stil sayfası, CSS yüklemesi yok.

Ücretsiz yerel alternatifler

pandoc — kanonik dönüştürücü: pandoc README.md -o readme.pdf. Enfes çıktı ve sonsuz yapılandırma, ama PDF çıktısı bir LaTeX motoru ister (çoğu zaman 1–4 GB'lık kurulum). Her hafta belge çeviriyorsanız değer; tek README için saçmalık.

VS Code uzantıları (ör. "Markdown PDF") — zaten VS Code'da yaşıyorsanız pratik; çıktı kalitesi uzantıya ve temaya göre değişir.

Tarayıcı önizleme + yazdırma: Markdown'ı önizleyen herhangi bir yerde işleyin (birçok düzenleyici HTML önizleme sunar), sonra Ctrl/Cmd+P → PDF olarak kaydet. Ücretsiz ve yerel, ama tarayıcı yazdırma tuhaflıklarını miras alırsınız: kapatmadıkça URL üst/alt bilgileri ve kod bloğunun ortasına düşen sayfa sonları.

macOS: yerleşik Markdown işleyici yok — Önizleme ve TextEdit .md'yi düz metin sayar; ham diyezleri ve yıldızları görürsünüz.

Pratik tuzaklar

Sayfa sonları otomatiktir. Uzun kod blokları sayfalar arasında bölünebilir. Elle sayfa sonu işareti yoktur; motor gereken yerde böler.
Çok geniş tablolar ve uzun kod satırları içerik genişliğinde ölçeklenir ya da kesilir — 200 karakterlik bir tablo satırı dikey sayfaya zarifçe sığamaz. Mümkünse satırları kısaltın.
Ön madde (dosyanın başındaki --- YAML'ı) gizlenmez, içerik sayılır — basılmasını istemiyorsanız çevirmeden önce silin. (En üstteki bir --- bloğu, biçime göre yatay çizgi artı metin olarak da işlenebilir.)
Emoji kısa kodları (:rocket: gibi) düz kalır; gerçek yapıştırılmış emoji karakterleri genellikle işlenir.
Bağlantı hedeflerini kontrol edin. Göreli bağlantılar ([docs](./docs/setup.md)) bağlantı olarak sağ kalır ama basıldıktan sonra işe yarar bir yere gitmez.

PDF bir kez var olunca her zamanki alet çantası geçerlidir: sayfa sayaçları için Üst bilgi ve alt bilgi ile damgalayın, bölümleri Birleştirme ile birleştirin ya da görsel ağırlıklı olanı küçültün.

Sık sorulan sorular

Kod blokları sözdizimi vurgusunu korur mu?

Evet — dil ipuçlu çitli bloklar (```python) renkli vurgu alır; ipucu olmadan, gri üzerinde düz eş aralıklıdır. Her iki durumda da girinti aynen korunur.

Tablolar gerçekten tablo olarak mı işlenir?

Evet — boru tabloları (GitHub stili), gölgeli başlık satırlı çerçeveli tablolara dönüşür. Hizalama iki noktalarını ayrıştırıcı dikkate alır.

Görselim PDF'te neden yok?

Yerel bir yolla başvurulmuş. Yükleme tek bir .md dosyasıdır; ./images/x.png hiçbir şeyi işaret etmez. Tam bir https:// URL'si kullanın ya da göreli yolların çözüldüğü pandoc ile yerelde çevirin.

GitHub'dan README'yi doğrudan çevirebilir miyim?

Önce ham .md dosyasını indirin, sonra yükleyin. Tam URL'lerde barındırılan rozetler ve görseller genellikle gelir; GitHub'a özgü özellikler (görev listeleri, mermaid) gelmez — yukarıdaki listeye bakın.

Fontları, kenar boşluklarını veya renkleri değiştirebilir miyim?

Bu araçta değil — bilerek temiz tutulmuş tek bir stil sayfasıyla gelir. Markalı bir tasarım için kendi CSS'inizle HTML'den PDF'e üzerinden gidin.

Boyut veya sayfa sınırı var mı?

Ücretsiz: dosya başına 20 MB ve günde 10 işlem — metin dosyaları için bu fiilen sınırsızdır. Tek bir Markdown kaynağından 50 sayfayı aşan PDF'ler sorunsuz üretilir.

Belgem gizli mi?

Aktarım HTTPS'tir ve dosyalar 1 saat içinde otomatik silinir. Yükleyemeyeceğiniz gizli malzeme için yerel yol pandoc'tur.

Ters yöne — PDF'ten Markdown'a gidebilir miyim?

Doğrudan değil. En yakını Metin çıkarma (düz metin, biçimsiz) ya da PDF'ten Word'e çevirip oradan temizlemektir.