Markdown'ı Çevrimiçi PDF'ye Dönüştür

Markdown'dan PDF'ye — Sık Sorulan Sorular ▼

Markdown'dan PDF'ye — .md Dosyalarını Paylaşılabilir Belgelere Dönüştürme

Markdown, geliştiricilerin yazma formatıdır. PDF ise herkesin paylaşım formatıdır. .md dosyalarını PDF'ye dönüştürmek, belgelerinize, README'lerinize ve teknik notlarınıza teknik olmayan okuyucuların her yerde açabileceği profesyonel, yazdırılabilir bir form kazandırır — Markdown işleyici gerekmez, GitHub hesabı gerekmez, özel görüntüleyici gerekmez.

Markdown Nedir?

Markdown, John Gruber tarafından 2004 yılında oluşturulan hafif bir düz metin biçimlendirme dilidir. Fikir: biçimlendirmeyi okunabilir düz metin olarak yazın (kalın için yıldız işaretleri, başlıklar için diyez işaretleri, listeler için tire), ardından HTML veya PDF olarak işleyin. .md dosyası sadece bir metin dosyasıdır — herhangi bir editörde açılır, sürüm kontrolünde temiz değişiklikler üretir ve neredeyse hiç disk alanı kaplamaz.

Orijinal Markdown belirtimi kasıtlı olarak minimaldi. O tarihten bu yana uzantılar birkaç eklemeyi standartlaştırdı:

• GitHub Flavored Markdown (GFM): Pratikte en yaygın kullanılan uzantı. Çitli kod blokları (``` sözdizimi), tablolar, görev listeleri (- [ ]), üstü çizili metin ve otomatik bağlantılar ekler. GitHub, GitLab, Bitbucket ve çoğu geliştirici wiki'sinde kullanılır.
• CommonMark: Orijinal Markdown'ın katı, belirsizliğe yer bırakmayan belirtimi. Uygulamalar arasında farklılık gösteren uç vakaları çözer. Discourse, Reddit ve Stack Overflow tarafından kullanılır.
• Pandoc Markdown: Pandoc belge dönüştürücüsü tarafından kullanılan bir üst küme. Alıntılar, dipnotlar, tanım listeleri, matematik (LaTeX) ve özel nitelikler ekler.

Markdown dosyaları .md uzantısını kullanır (zaman zaman .markdown). README dosyalarında, wiki'lerde (Confluence, Notion, Obsidian), Jupyter not defterlerinde ve statik site oluşturucularda (Hugo, Jekyll, MkDocs, Docusaurus) görünür.

Yaygın Markdown'dan PDF'ye Kullanım Alanları

README.md'yi Proje Belgesi Olarak Dışa Aktarma

Açık kaynak ve dahili projeler kendilerini README.md ile belgeler. Bir projeyi müşteriye teslim ederken, incelemede sunarken veya teslim edilebilirler sunarken README.md'yi PDF'ye dönüştürmek, okumak için GitHub erişimi gerektirmeyen temiz, bağımsız bir belge üretir.

Teknik Özellikten Paydaş Belgesine

Mühendisler teknik özellikleri Markdown'da yazar (mimari kararlar, API sözleşmeleri, sistem tasarım belgesi). Ürün yöneticileri, hukuk veya yöneticilerle paylaşmadan önce PDF'ye dönüştürmek, Markdown görüntüleyici gereksinimini ortadan kaldırır ve belgeye sabit, referans alınabilir bir form kazandırır.

Ders Notları ve Çalışma Rehberleri

Markdown'da (Obsidian, Typora, VS Code) not yazan eğitimciler ve öğrenciler, Markdown araçları kullanmayan sınıf arkadaşlarıyla yazdırmak, teslim etmek veya paylaşmak için PDF'ye dönüştürür.

Değişiklik Günlüğü ve Sürüm Notları

Keep a Changelog formatında CHANGELOG.md dosyaları yöneten yazılım ekipleri, depo dışında korunması gereken müşteri sürüm paketleri, uyumluluk kayıtları veya denetim izleri için bunları PDF'ye dönüştürür.

API Belgeleme Paketleri

Markdown'da yazılan API referans belgelerini (OpenAPI açıklamaları, uç nokta kılavuzları, entegrasyon kılavuzları) sabit, düzenlenemez formatta belgeleme gerektiren kurumsal müşterilere dağıtım için PDF'ye dönüştürür.

Doğru Şekilde İşlenenler

Markdown Varyantları: CommonMark - GFM - Pandoc

Dönüştürücü GitHub Flavored Markdown (GFM)'i işler — pratikte en yaygın varyant. GFM, CommonMark'ın bir üst kümesidir, dolayısıyla CommonMark belgeleri sorunsuz dönüşür. Pandoc'a özgü uzantılar (dipnotlar, alıntılar, tanım listeleri, LaTeX matematik) işlenmez ve çıktıda ham sözdizimi olarak görünür.

.md dosyanız Pandoc uzantıları veya LaTeX matematik kullanıyorsa bir sonraki bölümde açıklanan ardışık düzeni kullanın.

Alternatif Ardışık Düzen: Markdown → HTML → PDF

Tipografi, sayfa boyutu ve kenar boşlukları üzerinde tam kontrol için iki adımlı bir ardışık düzen doğrudan MD→PDF dönüştürmesinden daha iyi sonuçlar verir:

1. Markdown'ı HTML'ye dönüştürün Pandoc kullanarak: pandoc input.md -o output.html --standalone. Yazı tiplerini, sayfa genişliğini ve kod bloğu stilini kontrol etmek için --css=style.css ile özel CSS dosyası ekleyin.
2. HTML'yi PDF'ye dönüştürün Total HTML Converter kullanarak. Sayfa boyutunu (A4, Letter, Legal), kenar boşluklarını, DPI'ı ve üstbilgi/altbilgi metnini ayarlayın. Masaüstü dönüştürücü tek dosyaları veya tüm klasörleri tek çalıştırmada işler.

Bu yaklaşım, doğrudan MD→PDF araçlarının eşleşemeyeceği CSS kontrollü çıktı — özel yazı tipleri, renkli kod blokları, markalı başlıklar — sunar.

Çevrimiçi Araç ile Total HTML Converter Masaüstü Karşılaştırması

Tek seferlik README veya özellik dışa aktarmaları için çevrimiçi dönüştürücü en hızlı seçenektir. Belgeleme ardışık düzenleri, markalı çıktı veya tüm docs/ klasörünü dönüştürmek için Total HTML Converter'ı kullanın.

Yaygın Sorunlar ve Çözümleri

• Görseller PDF'de görünmüyor. Dönüştürücü URL (https://...) ile referans verilen görselleri işler. Tek bir .md dosyası yüklerken göreli yerel yollar (./images/screenshot.png) çözümlenemiyor. Görselleri base64 veri URI'leri olarak gömin veya kamuya açık görüntü barındırma hizmetlerine işaret eden mutlak URL'ler kullanın.
• Kod blokları stillendirme olmadan görünüyor. Sözdizimi renklendirmesi (anahtar kelimeleri renklendirme) sunucu tarafı sözdizimi vurgulayıcı gerektirir. Dönüştürücü kodu sabit aralıklı olarak oluşturur ancak renksiz. Vurgulanan kod blokları için Prism veya Highlight.js stil sayfasıyla HTML ardışık düzenini kullanın.
• Tablo sütunları çok geniş. GFM'deki uzun içerikli tablolar PDF sayfasını taşırabilir. Hücrelere açık satır sonları ekleyin veya masaüstü dönüştürücüyü özel CSS ile (table { table-layout: fixed; }) kullanarak sütun genişliğini kısıtlayın.
• LaTeX matematik ham $ sembolleri olarak görünüyor. Temel MD→PDF LaTeX'i işlemez. Önce matematiği HTML'ye işlemek için --mathjax ile Pandoc kullanın, ardından HTML'yi PDF'ye dönüştürün.
• Belirli sayfa boyutu veya kenar boşluğuna ihtiyacım var. Çevrimiçi araç varsayılan A4 ayarlarını kullanır. Tam sayfa düzeni kontrolü için Total HTML Converter'ı kullanın.

MD File

PDF File