Markdown'ı PDF'ye dönüştürme

Markdown neden PDF'ye dönüştürülür

Markdown, geliştiricilerin, yazarların ve Obsidian, Joplin ve Typora gibi not uygulamalarının metni saklama biçimidir: düz metin olarak okunabilir, bir uygulama gösterdiğinde de biçimlendirilmiş olur. Bu uygulamaların dışında bir .md dosyası yalnızca kare işaretleri ve yıldızlardan oluşan bir yığındır; bir müşteriye e-postayla göndermek, teslim etmek ya da yazdırmak istediğiniz şey bu değildir. Bu araç Markdown'ı tarayıcınızda, GitHub Flavored Markdown kurallarını izleyen açık kaynaklı bir ayrıştırıcı olan marked ile okur ve temiz bir belge olarak düzenler: başlıklar, kalın ve italik metin, numaralı ve madde işaretli listeler, onay kutulu görev listeleri, kenarlıklı tablolar, alıntılar ve sayfadan taşmak yerine satır kaydıran, eş aralıklı yazı tipindeki kod blokları. PDF'yi ardından tarayıcının kendi yazdırma motoru yazar; böylece metin keskin ve aranabilir kalır. Blogların ve statik site oluşturucuların kullandığı, dosyanın başındaki YAML ön bilgisi (front matter) PDF'ye alınmaz.

Markdown PDF'ye nasıl dönüştürülür

1. .md dosyanızı kutuya bırakın ya da tıklayıp seçin. Biçimlendirilmiş belgenin önizlemesi görünür.
2. Sayfa boyutunu, kenar boşluklarını ve metin boyutunu seçin.
3. “PDF oluştur” düğmesine tıklayın. Tarayıcınızın yazdırma penceresinde yazıcı veya hedef olarak “PDF olarak kaydet”i seçin ve dosyayı kaydedin.

Markdown ve PDF hakkında bilmeniz gerekenler

Yalnızca bağlantı verilmiş resimler

Markdown resimlere genellikle  gibi bir adresle ya da bir web bağlantısıyla işaret eder. Araçta yalnızca .md dosyası vardır, çevresindeki klasör yoktur ve araç web'den hiçbir şey indirmez; bu yüzden bu tür resimler açıklamalarıyla küçük bir kutu olarak görünür. Dosyaya data URL olarak gömülmüş resimler yazdırılır. Resimleri başka şekilde PDF'ye almak için Markdown'ı resimleri gösteren bir düzenleyicide açın ve oradan yazdırın.

Markdown içindeki HTML

<br>, <sup>, <details> gibi basit HTML ya da HTML ile yazılmış bir tablo korunur. Betikler, çerçeveler, formlar, stiller ve gömülü videolar kaldırılır, çünkü basılı bir belgeye ait değildirler ve güvensiz olabilirler.

Sözdizimi renklendirmesi yok

Kod blokları açık renkli bir çerçeveyle eş aralıklı yazı tipinde yazdırılır, ancak bir düzenleyicinin anahtar kelimeler ve dizeler için kullandığı renkler olmadan. Uzun kod satırları, sayfa kenarında hiçbir şey kesilmesin diye kaydırılır.

Markdown lehçeleri

Tablolar, görev listeleri, üstü çizili metin ve otomatik bağlantılar, çoğu uygulamanın paylaştığı GitHub kurallarını izler. Yalnızca bazı uygulamalarda bulunan dipnotlar, matematik formülleri, Mermaid diyagramları, notlar arası wiki bağlantıları veya Obsidian açıklama kutuları (callout) gibi uzantılar düz metin olarak gösterilir.