Markdown'dan PDF'e Dönüştürücü

Markdown'dan PDF'e dönüştürücü, Markdown kaynak metnini sabit bir PDF belgesine dönüştürür.

Markdown; başlıklar, paragraflar, vurgular, bağlantılar, listeler, tablolar, blok alıntılar, kodlar ve diğer belge öğeleri için düz metin sözdizimini kullanır. Dönüştürücü bu yapıyı yorumlar, desteklenen teknik içerikleri işler, baskı stillerini uygular ve bir Markdown düzenleyicisi olmadan paylaşılabilecek, incelenebilecek, arşivlenebilecek veya yazdırılabilecek bir PDF oluşturur.

“MD'den PDF'e” ifadesi de aynı anlama gelir. MD, Markdown için yaygın bir kısaltmadır ve .md, Markdown belgeleri için yaygın olarak kullanılan dosya uzantısıdır.

Bir .md dosyası, düz metin biçimindeki bir Markdown belgesidir. SolConverter, .md ve .txt kaynak dosyalarını kabul eder ve desteklenen Markdown içeriğini çevrimiçi bir iş akışı aracılığıyla PDF'e dönüştürür.

Bu, Markdown'ı düzenlenebilir kaynak olarak saklamak istediğiniz ancak müşteriler, meslektaşlar, öğrenciler, incelemeciler veya Markdown ile çalışmayan kişiler için kararlı bir belgeye ihtiyaç duyduğunuz durumlarda kullanışlıdır.

Aynı görevi tanımlayan yaygın ifadeler şunlardır:

• Markdown'dan PDF'e
• MD'den PDF'e
• Markdown dosyasından PDF'e
• .md dosyasından PDF'e
• Markdown'ı PDF'e dönüştürme
• Markdown'ı PDF olarak dışa aktarma
• Markdown'ı PDF olarak kaydetme

Tüm bu dönüştürme ihtiyaçları bu sayfa tarafından karşılanmaktadır.

SolConverter, teknik ve genel belgelerde yaygın olarak kullanılan Markdown yapılarını işler.

Desteklenen içerikler şunları içerir:

• ATX ve Setext başlıkları;
• paragraflar, satır sonları ve yatay çizgiler;
• kalın, italik ve üstü çizili metinler;
• içe içe listeler dahil sıralı ve sırasız listeler;
• onay kutuları içeren GFM görev listeleri;
• blok alıntılar ve içe içe blok alıntılar;
• satır içi kod ve çevrelenmiş kod blokları;
• Markdown bağlantıları, web otomatik bağlantıları ve e-posta otomatik bağlantıları;
• sola, ortala ve sağa hizalanmış GFM tabloları;
• kontrollü rowspan ve colspan özelliklerine sahip güvenli ham HTML tabloları;
• details, summary, kbd, sub, sup, figure ve figcaption gibi belge öğeleri;
• başlık bağlantıları (anchors);
• dosyanın başında yer alan ve yazdırılan içerik yerine meta veri olarak kabul edilen YAML front matter bloğu.

Hatalı biçimlendirilmiş kod çevrelemeleri veya sınırlayıcılar mümkün olduğunca yerel düzeyde tutulur, böylece bir biçimlendirme sorunu belgenin geri kalanını etkilemez.

SolConverter, desteklenen LaTeX ve MathML kodlarını MathJax SVG olarak işler. PDF yakınlaştırıldığında veya yazdırıldığında SVG çıktısı keskinliğini korur.

Matematik işleme hattı, ifadeleri Markdown ayrıştırmasından önce algılar; bu da alt çizgilerin, yıldız işaretlerinin, gösterim sınırlayıcılarının ve denklem ortamlarının Markdown ayrıştırıcısı tarafından değiştirilmesini önlemeye yardımcı olur.

Desteklenen matematiksel girdiler şunları içerir:

• $...$ ve \(...\) ile satır içi matematik;
• $$...$$ ve \[...\] ile blok matematik;
• equation, align, gather, multline, split ve cases gibi yaygın AMS ortamları;
• kesirler, kökler, üsler, indisler, toplamlar, çarpımlar, integraller, limitler ve seriler;
• matrisler, determinantlar, diziler ve tensör gösterimleri;
• kalkülüs, diferansiyel denklemler, doğrusal cebir, olasılık, istatistik, fizik ve kimya gösterimleri;
• Presentation MathML ve temel Content MathML işlemleri;
• \ce{...} ile yazılan kimya ifadeleri;
• \newcommand ve \DeclareMathOperator gibi belge kapsamındaki makrolar.

Uzun toplamsal ifadeler, sayfa kenarında kesilmek veya okunması zorlaşacak kadar küçültülmek yerine üst düzey işleçlerden bölünebilir. Tarayıcı bloğu sayfaya sığdırabildiğinde blok denklemler bir arada tutulur.

SolConverter, hatalı biçimlendirilmiş matematiği sorunun oluştuğu konumda izole eder.

Bir LaTeX veya MathML bloğu güvenli bir şekilde işlenemediğinde, dönüştürücü nötr bir kaynak yedeğini koruyabilir ve onu takip eden geçerli içeriği işlemeye devam edebilir. Aynı yerelleştirilmiş hata yaklaşımı diyagramlar ve görüntüler için de kullanılır.

Bu, uzun teknik belgeler için önemlidir. Hasarlı bir denklem, ulaşılamayan bir görüntü veya geçersiz bir diyagram, çevresindeki tüm geçerli sayfaların otomatik olarak atılmasına neden olmamalıdır.

Desteklenen Mermaid kod blokları PDF içinde SVG olarak işlenir. ZenUML, yerel olarak paketlenmiş bir Mermaid harici diyagram entegrasyonu aracılığıyla desteklenir.

Her geçerli diyagram bağımsız olarak işlenir ve kullanılabilir sayfa genişliğiyle sınırlandırılır. Bir diyagram başarısız olursa, SolConverter kaynak kodu içeren yerel bir yedek ekler ve kalan belgeyi işlemeye devam eder.

Şu anda desteklenen diyagram motorları Mermaid ve ZenUML'dir. PlantUML, Graphviz, D2, WaveDrom, BPMN, Nomnoml ve tam TikZ şu anda desteklenmemektedir.

Teknik belgeler genellikle açıklama, komut, yapılandırma ve kaynak kodunu bir arada barındırır. SolConverter, bir kod bloğu dili algılandığında sözdizimi vurgulaması uygulamak için Highlight.js kullanır.

Kod çıktısı şunları içerir:

• özel bir tek aralıklı (monospace) yazı tipi;
• kod blokları için görünür arka plan, kenarlık ve iç boşluk;
• kod bloğu bilgi dizesinden dil algılama;
• dil tanınmadığında güvenli kaynak çıktısı;
• kod içindeki matematik sınırlayıcılarının yorumlanmasına karşı koruma;
• sağdan sola yazılan belgelerdeki kodlar için soldan sağa izolasyon.

Bu sayede PDF, orijinal kaynağı korurken kodu etrafındaki metinden görsel olarak ayrı tutar.

SolConverter, içerikten belge yönünü algılar ve uygun yazı tipi yedekleriyle çok dilli PDF'leri destekler.

Desteklenen metin senaryoları şunları içerir:

• Vietnamca ve genişletilmiş Latin karakterleri;
• Arapça ve İbranice düzeni;
• Çince, Japonca ve Korece metinler;
• Hint alfabeleri;
• Kiril ve Yunan alfabeleri;
• karışık alfabeli belgeler;
• birleştirici işaretler;
• yazı tipi kapsamına bağlı olarak birçok Unicode sembolü ve emoji.

Ana belge yönü sağdan sola olsa bile matematik ve kod soldan sağa kalmaya devam eder.

SolConverter, genel HTTP ve HTTPS görüntülerinin yanı sıra PNG, GIF, JPEG, WebP ve SVG biçimlerindeki geçerli base64 veri görüntülerini destekler.

Görüntüler, en boy oranları korunarak sayfa genişliğiyle sınırlandırılır. Desteklenen görüntü meta verileri arasında alt metin, başlık, güvenli boyutlar, hizalama, şekiller ve altyazılar yer alır.

Kullanılamayan veya geçersiz bir görüntü, alt metnini içeren yerel bir yer tutucu ile değiştirilir. Dönüştürücü daha sonra tüm PDF'i bozmak yerine Markdown'ın geri kalanını işlemeye devam eder.

Güvenlik nedeniyle yerel yollar, localhost adresleri, özel IP değerleri, javascript: URL'leri ve desteklenmeyen şemalar engellenir. Depoya göreceli (repository-relative) varlık klasörleri, yüklenen bir Markdown dosyasıyla otomatik olarak paketlenmez.

Dönüştürücü; teknik belgeler, notlar, raporlar ve baskı çıktıları için tutarlı bir PDF düzeni uygular.

Mevcut web formu şunları kullanır:

• A4 sayfa boyutu;
• dikey yönlendirme;
• okunabilir çıktı için yönetilen kenar boşlukları;
• mevcut / toplam biçiminde sayfa numaralandırması;
• kaynak dosya adına dayalı bir çıktı başlığı;
• yazdırılan arka planlar.

İşleme sistemi aynı zamanda temel baskı düzeni korumalarını da uygular. Başlıkların sayfa altında tek başına kalmasını önlemeye çalışır, metin bloklarındaki dul ve yetim satırları azaltır, tarayıcı desteklediğinde tablo başlıklarını tekrarlar ve yeterli sayfa alanı olduğunda kod bloklarının, tablo satırlarının, şekillerin, görüntülerin, diyagramların ve blok denklemlerin bölünmesini önler.

Basit Markdown'ı dışa aktarmak kolaydır. Matematik, diyagramlar, tablolar, kodlar, çok dilli metinler, harici görüntüler ve sayfalama birbiriyle etkileşime girdiğinden, uzun teknik Markdown belgelerini dönüştürmek daha zordur.

SolConverter bu zorlu senaryo etrafında tasarlanmıştır. Markdown'dan PDF'e işleme hattı; MathJax SVG işlemeyi, Mermaid ve ZenUML'i, sözdizimi vurgulamayı, Unicode ve RTL desteğini, temizlemeyi (sanitization), ağ kontrollerini, blok düzeyinde hata izolasyonunu, iş ilerlemesini ve ayrı önizleme ile indirme sonuçlarını içerir.

4 Ağustos 2026'da tamamlanan dahili stres testlerinde, işleyici, 333 MathJax ifadesi içeren yapay 92 bölümlük bir kaynaktan 156 sayfalık bir PDF üretti. Test ayrıca yerel hata yönetimini ve satır bölünmesini doğrulamak için kasıtlı olarak hatalı biçimlendirilmiş MathML ve 84 terimli uzun bir ifade içeriyordu. Bunlar dahili test koşullarıdır, her belgenin aynı sonucu vereceğine dair bir garanti değildir.

Yüklenen Markdown belgeleri, doğrudan güvenilmemesi gereken ham HTML, görüntü URL'leri ve diğer içerikleri barındırabilir.

SolConverter, işlenen HTML'yi bir izin verilenler listesi kullanarak temizler, betikleri ve olay işleyicilerini kaldırır, güvenli olmayan URL'leri reddeder, tablo birleştirmelerini sınırlandırır, kısıtlayıcı bir içerik güvenlik politikası (CSP) uygular ve görüntü politikasının dışına çıkan tarayıcı isteklerini engeller.

Geçerli veri görüntüleri bir ağ isteği olmadan işlenebilir. Görüntü politikası aracılığıyla genel uzak görüntülere izin verilirken yerel, özel ve desteklenmeyen hedefler engellenir.

Dönüştürme işlemi başlamadıysa yeni yüklemelerin süresi 15 dakika sonra dolar. Başarılı bir dönüştürmenin ardından çıktı doğrulandıktan sonra kaynak silinir; başarısız girdiler orijinal 15 dakikalık süreyle sona erer. Tamamlanan PDF'ler iki saate kadar kullanılabilir kalır. Tüm veri döngüsü için Gizlilik Politikası belgesine bakın.

Markdown, yazma ve sürüm kontrolü için verimlidir. PDF ise belgenin kararlı bir görünüme ve yaygın olarak desteklenen bir dağıtım biçimine ihtiyaç duyduğu durumlar için kullanışlıdır.

Aşağıdaki durumlarda Markdown'ı PDF'e dönüştürmek isteyebilirsiniz:

• teknik dokümantasyonu bir kaynak deposunun dışına göndermek;
• sabit bir rapor, şartname, teklif veya el kitabı (runbook) sunmak;
• yazdırılabilir çalışma notları veya eğitim materyalleri oluşturmak;
• teknik olmayan okuyuculara bir README veya değişiklik günlüğü (changelog) dağıtmak;
• denklemleri ve diyagramları sayfa tabanlı bir biçimde incelemek;
• değişen bir belgenin belirli bir sürümünü arşivlemek;
• dokümantasyonu bir Markdown düzenleyicisine ihtiyaç duymadan paylaşmak;
• düzenlenebilir bir Markdown kaynağını korumak ve ayrı bir teslimat dosyası oluşturmak.

Yerel bir araç zinciri yapılandırmadan doğrudan yükleme, yönetilen işleme, önizleme ve indirme iş akışı istediğinizde çevrimiçi bir Markdown-PDF dönüştürücüsü en iyisidir.

Çevrimdışı dönüştürme, özel şablonlar, özel CSS, atıf işleme, betik tabanlı derleme hattı veya bir depo içinde toplu dönüştürmeye ihtiyaç duyduğunuzda Pandoc veya bir düzenleyici eklentisi gibi yerel bir araç daha iyi bir seçim olabilir.

SolConverter, yüklenen tekil belgeler için yönetilen Markdown'dan PDF'e işlemeye odaklanmıştır. Şu anda tam Pandoc atıf desteği, kullanıcı tanımlı özel CSS, otomatik PDF yer işaretleri, paketlenmiş göreceli varlık klasörleri veya tüm diyagram dillerini sunmamaktadır.

Teknik dokümantasyon

Mimari notlarını, API açıklamalarını, el kitaplarını (runbooks), sürüm dokümantasyonunu, şartnameleri ve dahili kılavuzları kararlı bir PDF belgesine dönüştürün.

Matematiksel ve bilimsel belgeler

Desteklenen LaTeX, MathML, matrisler, denklemler, kimya gösterimleri ve uzun ifadeleri PDF içinde SVG tabanlı matematik olarak işleyin.

Geliştirici belgeleri

Kod çevrelemelerini, satır içi kodları, tabloları, görev listelerini, diyagramları ve yapılandırılmış açıklamaları deponun dışında incelenebilecek bir belgede bir arada tutun.

Çok dilli raporlar

Vietnamca, CJK dilleri, Arapça, İbranice, Kiril, Yunanca, Hint alfabeleri ve karışık soldan sağa ve sağdan sola içerik barındıran PDF'ler oluşturun.

Notlar, raporlar and teklifler

Markdown dilinde yazın, ardından yazdırma, onaylama, paylaşma veya arşivleme için sabit bir belge oluşturun.

Kaynak biçimi veya istenen çıktı farklı olduğunda başka bir SolConverter aracı kullanın.

• Dosyaları Markdown'a dönüştürün
• PDF'i Markdown'a dönüştürün
• Word'ü Markdown'a dönüştürün
• HTML'i Markdown'a dönüştürün
• Excel'i Markdown'a dönüştürün
• CSV'yi Markdown'a dönüştürün
• Veri dönüştürücülere göz atın
• JSON'u CSV'ye dönüştürün
• CSV'yi JSON'a dönüştürün
• Teknik Markdown'dan PDF'e kılavuzunu okuyun