md2pdf hakkında — Girish Lade tarafından geliştirildi

md2pdf hakkında

Hikâye

md2pdf tanıdık bir sorunla başladı: ekranda rahatça okunan, ama gönderilmesi, arşivlenmesi veya yazdırılması gerektiği anda dağılan belgeler.

Markdown, hedef PDF istemediği sürece taşınabilirdir. Tarayıcı yazdırma iletişim kutusu belgeyi değil sayfayı korur: gezinme karışır, göreli görseller kırılır, geniş kod blokları kesilir ve tablolar can sıkıcı yerlerde bölünür. Masaüstü dönüştürücüler bunun bir kısmını çözer, ama genellikle kurulum, hesap veya sunucuya yükleme ister.

md2pdf daha dar bir yol seçer. Markdown’ı okur, depoya göreli varlıkları çözer, GitHub tarzı Markdown’ı tarayıcıda işler, sonucu temizler, baskı stilini uygular ve belgeyi tarayıcının kendi PDF motoruna verir. Kullanıcı genel bir README getirmesini istemedikçe kaynak cihazdan çıkmaz.

Misyon

Tarayıcısı olan herkesin Markdown’dan temiz bir PDF üretmesini sağlamak; hesap, abonelik veya yükleme olmadan. Dönüşümü anlaşılır tutmak: kullanıcı belgeyi görmeli, tema seçmeli ve tam olarak neyin yazdırılacağını bilmelidir.

Vizyon

Sıradan belgelerin taşınabilir olmak için tescilli bir masaüstü uygulamasına veya dönüştürme hizmetine ihtiyaç duymadığı bir web. Markdown zaten okunabilir, karşılaştırılabilir ve dayanıklıdır; PDF sadık bir çıkış olmalı, ikinci bir kapanmış alan değil.

Girish Lade

Yapımcı

Girish Lade

md2pdf yaratıcısı · LadeStack

Girish Lade, md2pdf’yi LadeStack’te geliştirir. Dönüştürücü, baskı temaları, belge kitabı akışı ve bu sitenin yerelleştirilmiş sürümleri üzerinde çalışır.

Proje bilinçli olarak küçük ve kendi kendine yeterlidir: statik bir Astro ön ucu, yalnızca tarayıcıda çalışan dönüştürme kodu ve çıktıyı vaat etmek yerine denetleyen bir test paketi.

Bu sayfadaki portre alanı gerçek bir fotoğraf için ayrılmıştır. Fotoğraf eklenene kadar bileşen, üretilmiş veya stok görsel yerine markalı bir monogram gösterir.

Ürün nasıl kuruldu

Önce tarayıcı

Markdown ayrıştırma, temizleme, içindekiler üretimi, baskı düzeni ve PDF birleştirme ziyaretçinin cihazında çalışır. Site statiktir; uygulama arka ucu yoktur.

Küçük ve açık sınırlar

Tek dosyalar 2 MB ile sınırlıdır. Bir belge kitabı en fazla 30 Markdown dosyası, dosya başına 750 KB, toplam 6 MB ve sınırlı sayıda API isteği barındırır.

Çıktı baskıdır

Son PDF’i tarayıcının yerleşik baskı motoru üretir. md2pdf temizlenmiş belgeyi ve baskı stilini sağlar; PDF işleme motoru olduğunu iddia etmez.

Dokuz dil

Arayüz, rehberler ve bu sayfa İngilizce, İspanyolca, Japonca, Korece, Basitleştirilmiş Çince, Rusça, Türkçe, Fransızca ve Brezilya Portekizcesi olarak yayımlanır.

Olduğu gibi başarılar

Bunlar yol haritası vaatleri değil, yayımlanmış yeteneklerdir.

Genel GitHub README içe aktarma, varsayılan dal keşfi ve depoya göreli görsel ve bağlantı yeniden yazma.
Markdown için yapıştırma, yükleme ve örnek akışları; GitHub tarzı tablolar, görev listeleri ve kod blokları.
Dört baskı teması: Clean, Business, Academic ve Dark.
Üç veya daha fazla başlığı olan belgeler için otomatik içindekiler.
Kapak, sıralı bölümler, aranabilir seçim ve baskı yalıtımı olan çok dosyalı belge kitabı.
Bölüm başına PDF dışa aktarma ve boyut ile dosya sayısı sınırlı ZIP indirmeleri.
Arayüzün, makalelerin ve bu sayfanın dokuz yerelleştirilmiş sürümü.
Hesap yok, yerel veya yapıştırılmış Markdown yüklemesi yok, sunucu tarafı işleyici yok.

Kimin için

md2pdf, araç zincirinden çok belge önemli olduğunda işe yarar.

Öğrenciler ve öğretmenler

Ders notlarını, ödevleri ve okuma paketlerini teslim edilebilir veya yazdırılabilir PDF’e dönüştürün.

Geliştiriciler ve teknik yazarlar

Dönüştürücü kurmadan README, RFC veya belge bölümlerini dışa aktarın.

Danışmanlar ve küçük ekipler

Markdown’ı üçüncü taraf hizmete göndermeden müşteriye temiz bir belge verin.

Arşivciler

Kaynağında değişebilecek veya kaybolabilecek belgelerin okunabilir, sayfalanmış kopyasını saklayın.

Gizlilik

Yerel dosyalar ve yapıştırılan Markdown tarayıcıda okunur ve yüklenmez. Genel GitHub getirmesi, README ve görselleri için GitHub’a anonim istekler yapar; özel depolar desteklenmez. Hesap yoktur ve belgeye bağlı dönüştürme analitiği yoktur.

Erişilebilirlik

Sayfalar anlamsal bölgeler, etiketli kontroller, görünür odak stilleri ve geçerli yolu koruyan bir dil değiştirici kullanır. Hareket sınırlıdır ve azaltılmış hareket tercihine uyar. Baskı stili başlıkları içerikleriyle tutar ve mümkün olduğunca kod bloklarının, tabloların ve görsellerin sayfalar arasında bölünmesini önler. Erişilebilirlik tek seferlik bir iddia değil, süren bir çalışma olarak ele alınır.

Sahiplik

md2pdf bir LadeStack ürünüdür. Ürün adı, site ve yayımlanan sürümler LadeStack’e aittir. Kaynak deposu github.com/girishlade111/ReadmePDF adresinde herkese açıktır; ürünün adı md2pdf olsa da depo özgün adını korur. md2pdf ücretsizdir.

LadeStack github.com/girishlade111/ReadmePDF

İletişim

Sorular, düzeltmeler ve erişilebilirlik bildirimleri memnuniyetle karşılanır. En güvenilir yol e-postadır; GitHub issue’ları herkese açık ve aranabilir.

Belgeyi koyun, PDF’i alın.

Hesap yok. Yerel dosyalar yüklenmez. Örnekle başlayın, kendi Markdown’ınızı yapıştırın veya genel bir README getirin.

Dönüştürücüyü aç