Markdown'dan PDF'e
Markdown yapıştırın veya bir .md dosyası bırakın. GitHub-Flavored Markdown destekli. %100 tarayıcınızda: hiçbir şey yüklenmez.
Bir .md veya .markdown dosyası bırakın
veya birini seçmek için tıklayın — yalnızca tarayıcınızda okunur
Teknik README'ler ve notlar için idealdir. Tablolar düzleştirilir ve dış görseller gizlilik için atlanır.
Your file is ready
Processed entirely in your browser — the file never left your device.
Markdown'dan PDF'e nasıl dönüştürülür
Üç adım. Her şey tarayıcınızda gerçekleşir.
Yapıştırın veya bırakın
Markdown'ınızı metin alanına yapıştırın veya bir .md dosyası bırakın. Canlı önizleme, çıktının nasıl görüneceğini gösterir.
Seçenekleri belirleyin
Sayfa boyutu, yön, gövde yazı tipi boyutu ve kod bloğu stili. Varsayılanlar çoğu README için çalışır.
Oluşturun ve indirin
marked HTML'e ayrıştırır, HTML bloklara belirteçlenir ve pdf-lib onları yerleştirir — hepsi sekmenizde.
imisspdf'te neden Markdown'dan PDF'e kullanmalısınız?
Kaynak makinenizde kalır
Markdown genellikle iç notlar, yayın taslakları veya kod bloklarında API anahtarları içerir. Hiçbir şey yüklenmez — sürecin her baytı yerel olarak çalışır.
Teknik belgeler için hızlı
Başlıklar, listeler ve çitli kod bir bakışta temiz şekilde oluşturulur. Yazdırma iletişim kutusu yok, Chrome yakalaması yok — yapıştır, tıkla ve indir.
GFM destekli
Üstü çizili, görev listeleri, çitli kod blokları, otomatik bağlantılar — ayrıştırıcı GFM modunda marked'dır. Tablolar düzleştirilir (bunu önceden söylüyoruz).
Burada "Markdown'dan PDF'e" ne anlama gelir
Markdown, çoğu geliştiricinin ve teknik yazarın gerçekte içerik oluşturduğu biçimdir — README dosyaları, blog taslakları, runbook'lar, API dokümantasyonu, iç wiki'ler. Hafiftir, sürümlenebilir ve GitHub'da temiz şekilde oluşturulur. Ama o belgeyi deponuzda çalışmayan biriyle paylaşma zamanı geldiğinde, genellikle doğru teslim biçimi bir PDF'tir: öngörülebilir şekilde yazdırılır, her cihazda açılır ve alıcının bir markdown görüntüleyici kurmuş olmasına bağlı değildir.
imisspdf'in Markdown'dan PDF'e aracı, yapıştırdığınız (veya .md dosyası olarak bıraktığınız) markdown kaynağını alır ve tarayıcınızda tek bir PDF üretir. Başlıklar hiyerarşilerini korur, listeler girintilerini sürdürür, çitli kod blokları tek aralıklı bir yazı tipinde oluşturulur ve alıntılar / yatay çizgiler alıntı ve çizgi gibi görünür. Sonuç, bir README, teknik bir rapor veya teknik olmayan bir okuyucuya teslim edilen bir değişiklik günlüğü için uygun, temiz ve süssüz bir PDF'tir.
Dönüştürme nasıl çalışır
Üç aşama baştan sona sekmenizde çalışır:
- marked ayrıştırıcısı, GFM kuralları etkin (çitli kod, üstü çizili, görev listeleri, otomatik bağlantılar) şekilde markdown'ınızı HTML'e dönüştürür.
- Küçük, düzenli ifadeye dayalı bir belirteçleyici HTML'i dolaşır ve onu düz bir blok belirteçleri dizisine — başlıklar, paragraflar, listeler, kod blokları, alıntılar — ve bunların satır içi parçalarına (kalın, italik, satır içi kod, bağlantılar) dönüştürür.
- pdf-lib, 14 standart PDF yazı tipini (gövde için Helvetica, kod için Courier) kullanarak blokları sayfalara yerleştirir. İçerik taştıkça yeni sayfalar eklenir.
Bu süreçte hiçbir şey bir sunucuyla konuşmaz. Uzaktan oluşturulan markdown, bir bulut işlevinde başlatılan başsız Chromium veya "saklamaya uymak için bir saatliğine" tutulan geçici dosya yok. PDF, DevTools'unuzda yazıldığını izleyebileceğiniz JavaScript baytlarıyla oluşturulur.
Araç ne zaman doğrudur — ne zaman değil
Bu araç, teknik içeriğin temiz ve arşivlenebilir bir PDF'ine ihtiyaç duyduğunuzda doğrudur: bir README, bir runbook, markdown'da yazılmış bir rapor, toplantı notları, bir öğretici. Satır içi biçimlendirmeyi, listeleri, kodu ve alıntıları o tür bir belgeden beklediğiniz gibi işler.
Oluşturulmuş bir siteyle piksel düzeyinde aslına uygunluk gerektiğinde (oluşturulmuş sayfada tarayıcınızın PDF olarak kaydet seçeneğini kullanın), tipografik tablolar gerektiğinde (yerel olarak Pandoc + LaTeX kullanın) veya sözdizimi vurgulamalı kod gerektiğinde (düzenleyicinizden HTML olarak dışa aktarın ve HTML'den PDF kullanın) yanlış araçtır. Doğru iş akışını seçmeniz için sınırları önceden söylüyoruz.
Gizlilik ve güvenlik
Markdown, bir sunucuda istemeyeceğiniz şeyleri içermesi en olası biçimlerden biridir: kod bloklarında API anahtarları, bağlantılarda iç URL'ler, henüz yayımlamadığınız yayın taslakları, toplantı notlarındaki müşteri adları. Sunucu tabanlı markdown'dan PDF'e araçlarının bunların hepsini içeri alması gerekir. Bu aracın mimarisi, bir gizlilik politikasına güvenmek zorunda olmadığınız anlamına gelir — süreçte yükleme adımı yoktur. Ağınızı kapatın ve sayfa yüklendikten sonra dönüştürme çalışmaya devam eder.
Sıkça sorulan sorular
Evet — ayrıştırıcı GFM modunda çalışır, dolayısıyla çitli kod blokları (``` ters tırnaklarla), üstü çizili metin (~~metin~~), görev listeleri, otomatik bağlantılar ve GFM'nin esnek paragraf kuralları çalışır. Dönüştürmeden sağ çıkmayan şey tablolardır: marked bir HTML <table> üretir, ancak bu araçtaki PDF oluşturucu tablo hücreleri çizmez, bu yüzden bir tablo düzleştirilmiş metin satırları olarak çıkar. README'niz büyük ölçüde tablolara dayanıyorsa sayfayı önce GitHub'da oluşturun ve ardından gerçek bir ızgara çıktısı için HTML'den PDF aracını kullanın veya ekran görüntüsü alın.
Hayır. Kod blokları, kodun girintisi ve yapısı okunaklı kalsın diye tek renkli sabit genişlikli Courier yazı tipiyle oluşturulur, ancak belirteçler dile göre renklendirilmez. Sözdizimi vurgulamayı bilinçli olarak atlıyoruz çünkü bu, asıl işi PDF'e dönüştürmek olan bir sayfaya 200 KB'tan büyük bir vurgulama kitaplığı yüklemeyi zorunlu kılardı ve PDF'ler genellikle bir IDE gibi okunmaz, yazdırılır veya arşivlenir. Renkli kod önemliyse, vurgulanmış HTML'i düzenleyicinizden HTML'den PDF aracımıza yapıştırın.
Dış görsel etiketleri () atılır — araç uzak görselleri getirmez. Bu, iki nedenle bilinçlidir: gizlilik (bir getirme işlemi IP'nizi ve yönlendireninizi görsel sunucusuna sızdırır) ve güvenilirlik (ağa bağlı oluşturma, tutarsız çıktı demektir). PDF'e gömülü görsellere ihtiyacınız varsa onları ayrı sayfalar olarak eklemek için JPG'den PDF veya PNG'den PDF araçlarını kullanın ya da PDF Birleştir ile markdown'dan oluşturulan PDF'e birleştirin.
Hayır. Hem markdown kaynağı hem de oluşturulan PDF tamamen tarayıcı sekmenizin içinde kalır. marked ayrıştırıcısı, HTML'den bloğa belirteçleyici ve pdf-lib'in tamamı bu sayfada bir kez yüklenen ve ardından yerel olarak çalışan istemci tarafı JavaScript'tir. Tarayıcınızın Geliştirici Araçları Ağ sekmesinden doğrulayabilirsiniz — sayfa yüklendikten sonra bir PDF oluşturmak sıfır giden ağ isteği yapar. Sekmeyi kapatın, her iz silinir; sunucu adımı olmadığı için sunucu tarafında geçici dosya da yoktur.
Altı markdown başlık düzeyinin tümü (# ile ###### arası) azalan boyutlarda PDF başlıkları olarak oluşturulur (h1 en büyüğü, h6 gövde metninden zar zor büyüktür). Hiyerarşi korunur, böylece ekran okuyucular ve PDF okuyucular ana hattı yakalar. Başlıkların içinde satır içi biçimlendirme (kalın, italik, satır içi kod) dikkate alınır. Otomatik içindekiler tablosu oluşturmayız — belgeniz buna ihtiyaç duyuyorsa basit bir markdown listesiyle kendiniz bir "## İçindekiler" bölümü ekleyin.
Izgara biçiminde değil. marked tabloyu doğru şekilde HTML'e ayrıştırır, ancak PDF oluşturucumuz bilinçli olarak basittir ve hücre kenarlıkları çizmez veya sütunları dağıtmaz. Tablo, satır satır bir metin satırları dizisi olarak çıkar; bu da 2x2'lik bir örnekten fazlası için genellikle okunaksızdır. Tablolar belgeniz için elzemse dürüst iş akışı şudur: en sevdiğiniz önizleyicide HTML'e dönüştürün, bir ekran görüntüsü alın ve JPG'den PDF kullanın — ya da tam LaTeX kalitesinde bir çıktı için yerel olarak Pandoc kullanın. Tabloları kötü biçimde oluşturmuş gibi yapmak yerine bu sınırlama konusunda açık sözlüyüz.
İyi bir çıktı almak için ipuçları
- Gerçek başlıklar kullanın. Bir satırın başındaki
#h1'e dönüşür; alt düzeyler temiz şekilde iç içe geçer. PDF okuyucular ve ekran okuyucular ana hattı yakalar. - Kod bloklarını çitli tutun. Üçlü ters tırnaklı bloklar Courier'de oluşturulur, böylece girinti, satır kaydırılsa bile doğru okunur.
- Çok görselli markdown'dan kaçının. Dış görseller indirilmez. Görselleri ayrı ayrı PDF'e dönüştürüp birleştirin.
- Tablolar için önce markdown'ı aracınızda oluşturup ekran görüntüsü alın. Veya tipografik tablolar için yerel olarak Pandoc kullanın.
İlgili PDF araçları
- HTML'den PDF'e — aynı oluşturucu, markdown yerine HTML girişiyle.
- TXT'den PDF'e — hiçbir biçimlendirme olmadan düz metin.
- PDF Birleştir — markdown PDF'ini görseller veya diğer dosyalarla birleştirir.
- PDF Sıkıştır — paylaşmak için çıktıyı küçültür.