Markdown'ı PDF'ye Dönüştürün, Belgeniz Bozulmadan Kalsın
Markdown, kaydırmalı ekranlar için yazılmıştır. PDF ise sayfalardan oluşur ve her sayfanın kenarları vardır. Çoğu dönüştürücü bu farkı görmezden gelir: Dosyayı bir tarayıcıya verir, yazdır'a basar ve çıkan her şeyi geri gönderir. Bu yüzden bir tablonun son dört sütunu kaybolur, bir başlık sayfanın en altında yalnız kalır ve bir README'nin en üstündeki logo, metin olarak yazdırılmış ham HTML satırı olarak gelir. MiniPNG ise önce belgeyi kağıda uygun şekilde yerleştirir ve bunu başarmak için neler yaptığını size bildirir.
Kağıda Sığan Tablolar
Bir Markdown tablosunda sütun genişlikleri yoktur. Söz diziminde bunları belirtecek bir yer yoktur, bu yüzden tabloyu doğrudan tarayıcıya gönderen bir dönüştürücü, tablonun kağıda sığmasını umar. MiniPNG'de ise her tablo çizilmeden önce ölçülür ve seçtiğiniz kağıda göre boyutlandırılır. On dört sütunlu bir dosya yolu tablosu bile kenar boşluklarının içinde kalır, uzun değerler kenardan taşmak yerine satır sonuna kaydırılır ve sonuçta bu işlemin yapıldığı belirtilir.
Sorunun daha sessiz kısmı ise ikinci sayfada ortaya çıkar. Uzun bir tablo genellikle başlık satırını ilk sayfada bırakır, okuyucu ise etiketsiz bir sayı ızgarasıyla karşılaşır. Burada ise başlık satırı tablonun ulaştığı her sayfada tekrar edilir ve hiçbir satır sayfa sonuyla ikiye bölünmez.
Kenar Boşluğunu Aşan Kodlar
Çit içine alınmış kodlar vurgulamasını ve dil etiketini korur. Uzun satırlar, kağıdın bittiği yerde kesilmek yerine, kaydırıldığını gösterecek şekilde sarılır. PDF'de kaydırma çubuğu yoktur, bu yüzden kaymayan bir satırın sağ tarafı eksik olur. Girintili bloklar, dili olmayan çitler ve satır içi kodlar da oldukları gibi aktarılır.
README'nizdeki Resimler
Bir logo ve bir dizi rozet neredeyse hiç Markdown ile yazılmaz. Resmi ortalamak mümkün olmadığından, README dosyaları genellikle ham HTML kullanır. HTML'yi işleyemeyen bir dönüştürücü ise genellikle bunu atlamak yerine kaçış karakteriyle yazar, yani belge bir ekran dolusu resim etiketiyle başlar. MiniPNG ise işaretlemeyi temizler, içindeki resimleri ve metinleri korur, böylece belgenin üstü olması gerektiği gibi görünür.
Resimler dosyaya gömülür, bağlantı olarak bırakılmaz; böylece PDF çevrimdışı da çalışır ve bir yıl sonra da açılır. Eğer bir resim alınamazsa, sonuçta bu sayılır ve belirtilir, resmin olması gereken yerde sessizce boşluk bırakılmaz.
Başlıklarınız Navigasyon Olur
Her PDF, kendi başlıklarınızdan oluşturulan bir yer imi ağacı taşır; böylece uzun bir belgeyi kenar çubuğundan gezebilirsiniz. İçindekiler sayfası isterseniz, istediğiniz başlık derinliğinde tıklanabilir bir sayfa da alırsınız. En üstte tek bir başlık varsa, bu başlık belge başlığı olarak okunur ve listeye eklenmez; tıpkı bir kitap başlığı gibi, bölüm başlığı gibi değil.
Dipnotlar dipnot olarak kalır, yükseltilmiş bir işaret ve okuduğunuz satıra geri dönen bir bağlantı ile. Görev listeleri kutularını, işaretli veya işaretsiz olarak korur. Not, uyarı ve ipucu kutuları renkli çubuğunu korur. Dosyanın başındaki ön bilgi, meta veri olarak kabul edilir ve sayfada gösterilmez. Tanım listeleri, üstü çizili metin, iç içe üç alıntı ve üç seviyeye kadar iç içe liste kendi biçiminde görünür.
Yapamadıklarını Size Söyler
Her dönüşüm, kendisiyle ilgili kısa bir raporla gelir: Kaç sayfa, metnin hangi yönde aktığı, kaç tablo, kaç kod bloğu, kaç resmin gömüldüğü ve kaçının alınamadığı. Bir fontta eksik karakter varsa, karakteri listeler. İçindekiler sayfası istediniz ama belgeye ekleyecek başlık yoksa, bunu bildirir; ön sayfası boş bir dosya vermez. Kendi eksiklerini gizleyen bir dönüştürücüye insanlar bu yüzden güvenmez.
Latin Olmayan Alfabeler
Fontlar PDF'nin içine gömülür, böylece belge, fontların hiçbiri yüklü olmasa da her makinede aynı açılır. Sağdan sola yazı, tüm dosya için değil, blok blok değerlendirilir; çünkü bu tür teknik belgelerde karakterlerin yarısı Latin harflerinden oluşur, dosya yolları ve sınıf adları içerir ve yine de sağdan sola okunur. Çit içine alınmış kodlar bu değerlendirmeden hariç tutulur ve her zaman soldan sağa ayarlanır; diğer tüm düzen ise düzgün şekilde aynalanır: madde işaretleri, alıntı çubukları ve tablo sütunları yer değiştirir. İtalik olmayan alfabelerde vurgulama, harfleri eğmek yerine kalınlıkla gösterilir.
Yapmayacakları
LaTeX işlenmez. Dolar işaretleri arasındaki bir blok, olduğu gibi metin olarak yazdırılır. Mermaid de çizilmez: mermaid olarak işaretlenmiş bir çit, etiketli bir kod bloğu olarak çıkar. Çince, Japonca ve Korece, aracın taşıdığı fontların dışında kalır; bu alfabelerdeki karakterler eksik olarak raporlanır, tahmin edilmez. Bunlar eksiklik değil, sınırdır ve kimse yükledikten sonra fark etmesin diye burada açıkça belirtilmiştir.
Pratik Kısım
Cihazınızdan, Google Drive'dan veya bir dosya bağlantısı yapıştırarak yükleyin. Markdown dosyaları tüm yaygın uzantılarıyla kabul edilir, düz metin de öyle. Kağıt boyutu A3, A4, A5, Letter, Legal veya Tabloid olabilir; dikey ya da yatay, dar, normal veya geniş kenar boşluklu. Sayfa numaraları ve sözdizimi vurgulama varsayılan olarak açıktır, isterseniz kapatabilirsiniz. Bir dosya gönderin, PDF olarak geri alın; birkaç dosya gönderin, ZIP olarak veya isterseniz sürekli sayfa numaralı tek birleştirilmiş PDF olarak alın. Metin gerçek metin olarak kalır; seçilebilir, aranabilir ve kopyalanabilir, kelimelerin resmi haline getirilmez.
Ne Elde Edersiniz?
- Kenar boşluklarının içinde kalan, başlık satırı her sayfada tekrar eden tablolar
- Kırpılmak yerine kaydırılan uzun satırlara sahip, sözdizimi vurgulu kodlar
- Ham HTML ile yazılmış olanlar dahil, dosyaya gömülü resimler
- Başlıklarınızdan oluşturulan bir yer imi ağacı ve isterseniz tıklanabilir bir içindekiler sayfası
- PDF'nin içine gömülü fontlar sayesinde, dosyanın her cihazda aynı görünmesi
- Dönüştürücünün yapamadığı her şeyin yazılı bir özeti; eksik karakterler ve resimler dahil
Sırada ne var?
Word dosyasıyla mı çalışıyorsunuz? Word'den PDF'ye aracı aynı yolu izler. Sonucu bir raporun diğer bölümleriyle birleştirmek için PDF Birleştir kullanın. Göndermeden önce dosya boyutunu küçültmek için PDF Sıkıştır seçeneğini kullanın.