Markdown'dan PDF'e çevirme

Nasıl çalışır?

Markdown dosyanızı kutuya dokunarak ya da tıklayarak seçin; .md, .markdown ve .txt uzantılı dosyalar girer. Araç dosyayı GitHub'ın kullandığı GFM kurallarıyla okur: # ile başlayan satırlar başlık olur ve seviyeye göre büyür, - ve 1. ile başlayan satırlar madde imli ya da numaralı liste olur (iç içe listeler içeri girer), üç ters tırnak arasındaki kod gri zeminli bir kutuda satırları bozulmadan yazılır, | ile kurulmuş tablolar eşit sütunlu satırlara dizilir ve başlık satırı gri zeminle ayrılır, > alıntıları içeri girer, --- yatay çizgi olur. Kalın ve eğik vurgular metin olarak korunur ama ayrı yazı yüzüyle çizilmez; bağlantılar "metin (adres)" biçiminde yazılır ki kâğıtta da bulunabilsin. Örnek: 40 satırlık bir README, 3 başlık ve 12 maddelik listesiyle A4'te 2 sayfaya sığar; sonuç satırı "2 sayfa · 3 başlık, 6 paragraf, 12 liste maddesi, 1 tablo" yazar. Görseller yüklenmez; yerine köşeli parantez içinde alt metni yazılır ve sonuç satırı kaç görselin böyle geçtiğini söyler.

Bu araç markdown to pdf, md to pdf aramalarıyla da biliniyor.

Markdown nedir?

Markdown, düz metin dosyasının içinde birkaç işaretle biçim vermenin adıdır: satırın başına # koyunca başlık, - koyunca liste maddesi, iki yıldız arasına alınca kalın metin olur. GitHub README dosyaları, Obsidian ve Notion notları, yazılım belgeleri ve pek çok blog yazısı bu biçimde yazılır; uzantısı .md'dir. Özel bir program gerektirmediği için yaygındır ama .md dosyasını telefonda açan kişi işaretleri olduğu gibi görür; bu araç işaretleri sayfa düzenine çevirip herkesin açtığı ve yazdırdığı bir PDF üretir.

GFM (GitHub Flavored Markdown) nedir?

GFM, GitHub'ın Markdown'a eklediği ve bugün çoğu editörün varsayılan saydığı kural setidir: | işaretleriyle tablo, - [ ] ile görev listesi, iki tilde arasında üstü çizili metin ve üç ters tırnakla açılan kod bloğu bu setten gelir. Bu araç dosyayı GFM kurallarıyla okur; yani README'nizdeki tablo PDF'te de tablo olur, görev listesi [x] ve [ ] işaretleriyle yazılır. Editörünüz farklı bir lehçe kullanıyorsa (örneğin Wiki sözdizimi) o işaretler düz metin olarak geçer.

Markdown ile PDF arasındaki fark nedir?

Markdown yazarken kullanılan bir kaynak biçimdir: küçük, düzenlenebilir, sürüm takibine uygun, ama görünüşü açan programa bağlıdır ve sayfa kavramı yoktur. PDF ise sonuç biçimidir: kâğıt ölçüsü, kenar boşluğu ve sayfa sırası dosyanın içindedir, her cihazda aynı görünür, yazdırılır ve e-posta ekine konur. Bu araç ikisi arasında tek yönlü köprüdür: .md dosyasındaki yapıyı sayfa düzenine çevirir ve metni seçilebilir olarak yazar; PDF'i tekrar Markdown'a çevirmek isterseniz metni PDF'ten çıkarma aracını kullanıp işaretleri elle eklemeniz gerekir.

Neler sayfa düzenine geçer, neler düz metin kalır?

Sayfa düzenine geçenler: altı seviye başlık (büyüklük ve kalınlıkla), madde imli ve numaralı listeler (iç içe seviyeler 18 noktalık girintiyle), görev listeleri ([x] ve [ ]), kod blokları (gri zeminli kutu, satır sonları ve boşluklar korunur), tablolar (eşit genişlikte sütunlar, uzun hücre kendi içinde sarılır, başlık satırı gri), alıntılar (girinti) ve yatay çizgiler. Tek bir yazı yüzü gömüldüğü için kalın ve eğik vurgular ayrı çizilmez; metin olduğu gibi kalır, yıldız ve alt çizgi işaretleri düşer.

Düz metin olarak geçenler: satır içi kod (ters tırnak içi) olağan yazıyla yazılır; bağlantı "metin (adres)" olur ki kâğıttan okunabilsin; ham HTML etiketleri atılır ve içindeki metin kalır. Görsel dosyaları yüklenmez: araç ağa çıkmaz ve bilgisayarınızdaki göreli yolu açamaz; görselin yerine "[görsel: alt metni]" yazılır ve sonuç satırı kaç görselin böyle yazıldığını söyler. Görselli belge için PDF'i üretip görselleri PDF düzenleyicide eklemek ya da belgeyi önce HTML'ye çevirmek gerekir.

Hangi durumda hangi ayar?

Kâğıt ölçüsünü varsayılanda bırakın: Türkçe, Almanca, Fransızca ve İspanyolca sayfalarda A4, İngilizce sayfada Letter seçilir; ABD'deki bir alıcıya gidecek Türkçe belge için Letter'ı elle seçebilirsiniz. Yazı boyutu gövde metnine uygulanır, başlıklar oranla büyür: 11 punto olağan okuma boyudur; 10 punto uzun bir belgeyi daha az sayfaya sığdırır, 12 punto ekranda okunacak ya da yaşlı bir okura verilecek belge için rahattır. Kod blokları gövdeden 1,5 punto küçük, tablo hücreleri 1 punto küçük yazılır.

Belge çok geniş bir tablo taşıyorsa sütunlar daralır ve hücre metni sarılır; sekiz sütunun üstünde tablo A4 dikeyde okunaklı kalmayabilir, böyle tabloyu belgede bölmek daha iyi sonuç verir. Türkçe harfler için Noto Sans'ın Türkçe alt kümesi PDF'e gömülür; yazı tipi betiği yüklenemezse araç standart yazı tipine düşer, ğ ve ş harflerini ASCII karşılığıyla yazar ve sonuç satırında bunu söyler — sayfayı yenileyip yeniden denemek çoğu zaman yeter.

Sık sorulanlar

README.md dosyasını PDF'e nasıl çeviririm?

Dosyayı kutudan seçip "PDF'e çevir" düğmesine basın; başka ayar gerekmez. Başlıklar, listeler, tablolar ve kod blokları sayfa düzenine geçer, metin seçilebilir kalır. Birden çok .md dosyası seçerseniz her biri kendi adıyla ayrı PDF olarak iner; onları tek belgede toplamak için inen dosyaları PDF birleştirme aracına verin.

Tablolar PDF'te görünüyor mu?

Evet. | işaretleriyle kurulmuş GFM tabloları eşit genişlikte sütunlara dizilir, başlık satırı gri zeminle ayrılır ve uzun hücre metni kendi hücresinde alt satıra sarılır; sayfa sonuna denk gelen satır bölünmez, bütün olarak sonraki sayfaya geçer. Sütun genişlikleri içeriğe göre değil eşit paylaştırıldığı için çok sütunlu tablolarda yazı daralır.

Kalın ve eğik yazı neden PDF'te düz çıktı?

PDF'e tek bir yazı yüzü gömülür; kalın ve eğik yüz için ayrı yazı tipi dosyaları gerekir ve bu, sayfanın yüklediği veriyi ikiye katlardı. Vurgu işaretleri (yıldız, alt çizgi) düşer, metin olduğu gibi kalır; başlıklar ise büyüklük ve kalınlaştırmayla ayrılır. Vurguların korunması şartsa belgeyi önce HTML'ye çevirip tarayıcının yazdır menüsünden PDF kaydedebilirsiniz.

Dosyam bir yere yükleniyor mu?

Hayır. Markdown dosyanız cihazınızdan çıkmaz: dosyayı okuma, işaretleri çözme ve PDF'i yazma işinin tamamı tarayıcınızın içinde olur. Yayınlanmamış bir yazılım belgesi ya da kişisel not için bu önemlidir; sayfa açıldıktan sonra internet kesilse bile dönüşüm çalışır.