Düzenleyiciye geç
mdprint

Ücretsiz · Gizli · Kayıt yok

Markdown'ı şık biçimde yazdırın

Yapıştırın, yazın veya bir dosya bırakın. Önizleme anında güncellenir. Tarayıcınızdan yazdırın veya PDF olarak indirin.

100% local No sign-up 18 languages
Markdown kaynağı
Önizleme

Aşağıdaki düzenleyiciye yazmaya başlayın

Tablolar Kod vurgulama Matematik (KaTeX) Mermaid diyagramları Görev listeleri Dipnotlar Otomatik içindekiler Yazdırmaya hazır Yerel işleme Kayıt yok 18 dil Koyu mod Tablolar Kod vurgulama Matematik (KaTeX) Mermaid diyagramları Görev listeleri Dipnotlar Otomatik içindekiler Yazdırmaya hazır Yerel işleme Kayıt yok 18 dil Koyu mod

Yerel işleme

Yerel işleme. Dosyalarınız cihazınızdan asla çıkmaz. Yükleme yok, sunucu yok, içerik takibi yok.

Gerçek zamanlı önizleme

Ne görüyorsanız onu yazdırırsınız. Önizleme, yazdırılan çıktıyla aynıdır.

Dünyanın her yerinde çalışır

18 dil. Sağdan sola desteği. CJK yazı tipleri. Bir kez yüklendikten sonra çevrimdışı çalışır.

Nasıl çalışır

Üç adım. Hesap yok.

Düzenleyiciyi aç
01

Yapıştırın veya yükleyin

Markdown'u doğrudan yazın, panodan yapıştırın veya bir .md dosyasını düzenleyiciye bırakın.

02

Anında önizleme

Yazdıkça canlı önizlemenin güncellenmesini izleyin. Başlıklar, tablolar, kod, matematik, diyagramlar - hepsi işlenir.

03

Yazdırın veya indirin

Tarayıcının yazdırma penceresi için Yazdır'a basın ya da düzgün sayfa sonlarıyla temiz bir PDF indirin.

GitHub Flavored Markdown ve gerçekten kullandığınız uzantılar.

Markdown'ın yapabildiği her şey, yazdırılabilir

GFM tabloları

Hizalı sütunlar, başlıklar, GitHub söz diziminin tamamı.

Kod vurgulama

190'dan fazla dilde otomatik algılamayla highlight.js.

Matematik (KaTeX)

Satır içi $x^2$ ve blok $$...$$ denklemleri hızlı işlenir.

Mermaid diyagramları

Akış, dizi, Gantt, sınıf - net SVG olarak çizilir.

Görev listeleri

Yazdırılmaya uygun onay kutusu söz dizimi.

Dipnotlar

Sayfa sonlarında bozulmayan referans dipnotları.

Otomatik içindekiler

Başlıklarınızdan oluşturulan isteğe bağlı içindekiler tablosu.

Yazdırmaya hazır stiller

Sayfa sonları, tekrarlanan tablo başlıkları, temiz tipografi.

Koyu mod düzenleyici

Varsayılan açık. Geç saatte yazmak için koyu.

Dosya içe aktarma

.md, .markdown, .txt. Sürükle bırak ya da düğme.

18 dil

İngilizce, Felemenkçe, Fransızca, Arapça, Çince ve daha fazlasında yerel arayüz.

Sıfır takip

İçeriğinizi asla görmeyiz. Plausible sayfa görüntülemelerini sayar, başka bir şey değil.

Özellikler

mdprint'in desteklediği her şey, örnekleriyle.

Markdown ayrıştırma

Tam CommonMark ve GitHub Flavored Markdown.

mdprint arka planda markdown-it kullanır - JavaScript ile yazılmış, hızlı ve şartnameye uyumlu bir Markdown ayrıştırıcı. CommonMark'ı tam olarak uygular, üzerine GitHub Flavored Markdown ekler. Çift tilde ile üzeri çizili, çıplak URL'lerin otomatik bağlantısı, dil etiketli çitli kod blokları ve dikey çizgi söz dizimli tablolar github.com'daki gibi çalışır. Markdown'ınız bir GitHub README'de işleniyorsa burada da işlenir.

Tablolar

Hizalamayla GFM dikey çizgi ve tire söz dizimi.

Tablolar standart dikey çizgi ve tire söz dizimini kullanır. Başlık satırı, her sütun için --- içeren ayırıcı satır ve veri satırları. Hizalamayı kontrol etmek için ayırıcının sol, sağ veya her iki ucuna iki nokta ekleyin: sol için :--, sağ için --:, orta için :-:. Sayfa sonlarına yayılan uzun tablolar, başlıklarını yazdırılan her sayfada otomatik olarak tekrarlar.

Görev listeleri

Yazdırmaya uygun çıktıyla onay kutusu söz dizimi.

İşaretsiz görev için - [ ], işaretli için - [x] yazın. Önizlemede gerçek onay kutuları olarak görünür ve kâğıtta belgeyi doğru okutmak için dolu ya da boş kareler olarak yazdırılır. Görev listeleri iç içe madde listelerinde de çalışır, böylece hiyerarşik yapılacak listeleri oluşturabilirsiniz.

Dipnotlar

Sayfa sonlarında bozulmayan referans dipnotları.

Metne [^1] ile bir dipnot işareti ekleyin, ardından içeriği başka bir yerde [^1]: dipnot metni ile tanımlayın. Dipnotlar belgenin sonunda, göründükleri yere geri referanslarla toplanır. Dipnotlar bölümü ayrı bir stile sahiptir ve basılı bir makalede beklediğiniz gibi daha küçük yazı tipi kullanır.

Kod vurgulama

highlight.js ile otomatik algılamada 190'dan fazla dil.

Çitli kod blokları otomatik olarak söz dizimi vurgulaması alır. Doğru ayrıştırma için dili açılış geri tırnaklarının hemen ardından belirtin (```python, ```typescript, ```rust) ya da atlayın ve highlight.js dili içerikten algılasın. Tek geri tırnaklı satır içi kod, hafif tek aralıklı bir arka plan alır. Kod blokları, yazdırıldığında ortadan bölünmeyi önleyecek şekilde biçimlendirilir.

Matematik (KaTeX)

Yazdırma kalitesinde satır içi ve görüntüleme denklemleri.

Satır içi matematik tek dolar işareti kullanır ($E = mc^2$). Blok matematik kendi satırlarında çift dolar işareti kullanır. mdprint ikisini de KaTeX ile işler; MathJax'ten hızlıdır ve PDF dışa aktarma sonrasında bile netliğini koruyan, yazdırma kalitesinde çıktı verir. Tüm standart LaTeX matematik komutları desteklenir: kesirler, integraller, toplamlar, matrisler, Yunan harfleri ve tam AMS-math sembol kümesi.

Bunu düzenleyicide deneyin →

Mermaid diyagramları

Akış, dizi, Gantt, sınıf ve durum diyagramları.

Dil etiketi mermaid olan çitli bir kod bloğu yazın; mdprint bunu net bir SVG diyagram olarak işler. graph LR veya graph TD ile akış şemaları, aktörler arasında dizi diyagramları, tarihli Gantt grafikleri, ilişkilerle sınıf diyagramları, durum makineleri - Mermaid'in desteklediği tüm diyagram türleri çalışır. SVG işleme, diyagramların her yazdırma çözünürlüğünde keskin kalması anlamına gelir.

Otomatik içindekiler

Başlık yapınızdan oluşturulur.

Belgenizin herhangi bir yerine ${toc} (veya [[toc]]) ekleyin; ardından gelen H2 ve H3 başlıklarından otomatik olarak oluşturulmuş bir içindekiler tablosu elde edersiniz. İçindekiler önizlemede bağlantı listesi, yazdırılan PDF'te iç içe bir anahattır. Okuyucuların bir bölüme atlamak istediği uzun belgelerde işe yarar.

Yazdırmaya hazır stiller

Sayfa sonları, tekrarlanan başlıklar, temiz tipografi.

Yazdırma stil sayfası özellikle bu iş için tasarlanmıştır. Kod blokları, tablolar ve diyagramların ortasında sayfa sonu önlenir. Tablo başlıkları yazdırılan her sayfanın üstünde tekrarlanır. Sayfanın kendisi ayarlarınızı kullanır - A4 veya Letter, dikey veya yatay, normal/dar/geniş kenar boşlukları. Arayüz kaybolur: araç çubuğu yok, düzenleyici yok, yalnızca işlenmiş belge.

Koyu mod düzenleyici

Varsayılan açık. İstediğinizde koyu.

Açılış sayfaları açık kalır çünkü uzun okuma beyaz arka planda daha kolaydır. Düzenleyici en sık karanlıktan sonra kullanılan bölüm olduğu için sayfa temasından bağımsız kendi açık/koyu anahtarına sahiptir. Tercihiniz yerel olarak hatırlanır.

Dosya içe aktarma

Sürükle bırak ya da düğme. .md, .markdown, .txt.

Bir Markdown dosyasını düzenleyicinin herhangi bir yerine bırakın; mdprint yükler. İçe Aktar düğmesi de bir dosya seçici aracılığıyla aynı şeyi yapar. Dosyalar tarayıcının FileReader API'siyle okunur - hiçbir şey yüklenmez. Belgeniz H1 ile başlamıyorsa dosyanın adı PDF dosya adı önerisi olarak kullanılır.

Çok dilli arayüz

18 dil, RTL desteği, CJK yazı tipleri.

Arayüzün kendisi 18 dile çevrilmiştir: İngilizce, Felemenkçe, Fransızca, Almanca, İspanyolca, Portekizce, Basitleştirilmiş Çince, Geleneksel Çince, Rusça, Arapça, Vietnamca, Japonca, Korece, İtalyanca, Tayca, Endonezce, Türkçe ve Hintçe. Arapça, sağdan sola okuma için düzeni çevirir. CJK ve Hint yazıları için her cihazda doğru görünmesini sağlayacak uygun yedek yazı tipleri vardır.

mdprint nasıl kullanılır

Pratik bir rehber. Yukarıdan aşağıya okuyun ya da ihtiyacınız olan bölüme atlayın.

Başlarken

mdprint'i denemenin en hızlı yolu ana sayfadaki düzenleyiciye yazmaya başlamaktır. Her özelliği - tablolar, kod, matematik, diyagramlar - kullanan örnek bir belgeyle açılır, böylece tamamlanmış bir sayfanın neye benzediğini hemen görürsünüz. Örneği silin ve kendi içeriğinizi yazın ya da nerede yazdıysanız oradan yapıştırın.

Bilgisayarınızda zaten bir Markdown dosyası varsa onu yüklemenin iki yolu vardır. İlki, dosyayı dosya yöneticinizden sürükleyip düzenleyici bölmesine bırakmaktır. Sürüklerken bırakma alanının çevresinde bir vurgu belirir. Dosyayı bırakın, düzenleyici içeriğiyle dolar. İkincisi, araç çubuğundaki İçe Aktar düğmesine tıklayıp dosyayı seçicide seçmektir. Her iki yöntem de dosyayı yerel olarak okur - hiçbir şey yüklenmez.

mdprint .md, .markdown ve .txt dosyalarını kabul eder. .txt uzantısı, Markdown olarak yazılmış ancak başka bir araç tarafından genel bir uzantıyla kaydedilmiş belgeler için kullanışlıdır. Farklı bir uzantıya sahip bir dosyayı içe aktarmaya çalışırsanız mdprint bir hata gösterir ve mevcut içeriğinize dokunmaz.

Markdown yazmak

Daha önce hiç Markdown yazmadıysanız kuralları beş dakikada öğrenilebilecek kadar azdır. Düz metin yazarsınız ve işin çoğunu dört karakter yapar. Satırın başındaki # simgesi bir başlık oluşturur - en büyük başlık için bir #, en küçük için altı ######. Bir kelimenin etrafındaki * ve _ simgeleri her iki tarafta bir tane olduğunda italik, iki tane olduğunda kalın yapar. Satırın başındaki - veya * simgesi bir madde imi oluşturur. Bir maddeyi diğerinin altına yuvalamak için iki boşluk girinti yapın.

Kod, geri tırnaklarla işlenir. Bir ifadenin her iki yanındaki bir geri tırnak onu `satır içi kod` olarak biçimlendirir. Tek başına bir satırda üç geri tırnak bir kod bloğunu başlatır, üç tane daha bitirir. Açılış üç geri tırnaktan hemen sonra bir dil adı koyarsanız (```python, ```typescript, ```sql) kod bloğu o dilde söz dizimi vurgulaması alır. Dil ipucu olmadan, vurgulayıcı içerikten tahmin etmeye çalışır; bu, popüler diller için genellikle işe yarar.

Bağlantılar ve görseller hem köşeli hem yuvarlak parantezler kullanır. Bağlantı şöyledir: [gördüğünüz metin](URL). Görsel aynı şeyin başına ünlem işareti eklenmiş hâlidir: ![görseli açıklayan alt metin](görselin URL'si). PDF'e yazdırırken, herkese açık sunuculardaki görsel URL'leri çekilir ve gömülür. Yerel makinenizdeki veya kimlik doğrulama arkasındaki görseller işlenmez - gerekliyse onları doğrudan base64 veri URL'leri olarak düzenleyiciye bırakın.

Tablolar Markdown'da kaynakta zahmetli görünen ama temiz işlenen tek parçadır. Başlık satırı, tire ayırıcı satır ve bir veya daha fazla veri satırı, hepsi dikey çizgilerle ayrılır. Sütunların kaynakta hizalanması gerekmez - boşlukları işleyici hâlleder. Hizalamayı kontrol etmek için ayırıcı satırdaki tirelerin bir veya her iki ucuna iki nokta ekleyin: sol için :---, sağ için ---:, orta için :---:.

Gelişmiş özellikleri kullanmak

Matematik denklemleri, dolar işaretleri içinde TeX söz dizimini kullanır. Her iki tarafta tek bir dolar işareti satır içi matematik verir: $a^2 + b^2 = c^2$. Kendi satırlarında iki dolar işareti, satırın ortasında yer alan ve daha büyük bir görüntüleme denklemi verir. Beklediğiniz tüm LaTeX matematik komutları - \frac, \int, \sum, \sqrt, Yunan harfleri, matrisler, AMS sembol kümesi - çalışır çünkü mdprint aynı söz dizimini uygulayan KaTeX'i kullanır.

Diyagramlar, mermaid dil etiketiyle çitli bir kod bloğunun içinde Mermaid söz dizimini kullanır. En basit diyagram bir akış şemasıdır: graph LR (soldan sağa) veya graph TD (yukarıdan aşağı) ile başlayın, sonra oklarla bağlanmış düğümler yazın. Mermaid ayrıca dizi diyagramlarını (aktörler arası zaman içindeki mesaj akışını gösterir), Gantt grafiklerini (bağımlılıklı proje zaman çizelgeleri), sınıf diyagramlarını (nesne ilişkileri) ve durum diyagramlarını (durum makineleri) destekler. Mermaid belgelerinde her tür için örnekler vardır.

Dipnotlar, ayrıntılı alıntıları veya kenar notlarını eklerken metnin okunabilir kalmasını sağlar. Metninize [^1] ile bir dipnot işaretleyin (sayı herhangi bir şey olabilir - çıktıda yeniden numaralanırlar). Belgenin başka bir yerinde, dipnotu [^1]: dipnot içeriği ile tanımlayın. mdprint tüm dipnotları yazdırılan belgenin sonunda toplar ve her dipnotu metinde göründüğü yere bağlayan geri referanslar ekler.

Belgeniz uzunsa, içindekiler tablosunun görünmesini istediğiniz yere kaynağa düz olarak [[toc]] metnini koyun. mdprint bunu belgedeki her H2 ve H3'e iç içe bir bağlantı listesiyle değiştirir. Yazdırılan PDF'te aynı içindekiler tablosu, PDF okuyucuların kullanabileceği bir gezinme anahattı olur.

Çıktıyı özelleştirmek

PDF'inizin nasıl oluşturulduğunu kontrol etmek için araç çubuğundan Ayarlar panelini açın. Sayfa boyutunun iki seçeneği vardır: A4 (Kuzey Amerika dışındaki standart) veya Letter (Kuzey Amerika içindeki standart). Yön dikey ve yatay arasında geçiş yapar - geniş tablolar veya diyagramlar içeren belgeler için yatay yararlıdır. Kenar boşlukları üç hazır ayar sunar: dar, yoğun içerik için daha fazla kullanılabilir alan verir; normal alışılmış orta yoldur; geniş ise basılı bir kopyada el yazısı notlar için yer bırakır.

Düzenleyicinin, sayfanın geri kalanından bağımsız kendi açık ve koyu temaları vardır. Araç çubuğundaki anahtar ikisi arasında geçiş yapar. Önizleme ve yazdırma çıktısı ne olursa olsun açık modda kalır çünkü kâğıda iyi basan açık arka planlardır.

Aynı ayar kümesini düzenli olarak kullanıyorsanız, son seçiminiz yerel olarak hatırlanır ve aynı tarayıcıda mdprint'i bir sonraki açışınızda otomatik olarak uygulanır.

Yazdırma mı PDF indirme mi

Yazdır düğmesi tarayıcınızın yerel yazdırma penceresini açar. Oradan, her modern işletim sistemi hedef olarak PDF olarak kaydet sunar - macOS, Windows ve Linux'ta Chrome, Firefox, Safari ve Edge bunu destekler. Yazdırma penceresinden geçmek size en fazla kontrolü verir: herhangi bir yazıcıyı seçebilir, her sayfayı önizleyebilir, sürücünüz destekliyorsa sayfa başına yönü değiştirebilir ve bazı yazıcılarda kâğıt tepsisini veya zımbalamayı değiştirebilirsiniz.

PDF İndir düğmesi yazdırma penceresini atlar ve tarayıcıda doğrudan bir PDF dosyası oluşturup indirmeyi başlatır. Çıktıyı biçimlendirmek için mevcut Ayarlarınızı (sayfa boyutu, yön, kenar boşlukları) kullanır. Tam olarak ne istediğinizi bildiğinizde ve yazdırma penceresinin esnekliğine ihtiyacınız olmadığında bu yol daha hızlıdır. Sayfayı yüksek çözünürlüklü bir görüntü olarak işleyip o görüntüyü PDF'e yerleştirerek çalışır, böylece sonuç her zaman ekranda gördüğünüzle aynı olur. Bunun bedeli: sayfa bir görüntüye dönüştüğü için bu PDF'deki metin seçilemez ve içinde arama yapılamaz.

İki yol, dosyanın içinde ne kaldığı bakımından farklıdır. Yazdır düğmesi üzerinden PDF olarak kaydet, metni metin olarak tutar: seçilebilir ve aranabilir kalır, her yakınlaştırmada keskin görünür ve diyagramlar vektör olarak kalır. PDF İndir ise tek tıkla alınan bir görüntü anlık görüntüsüdür, yani hızlı ve piksel düzeyinde doğrudur ama metin seçilemez. Seçilebilir metin ya da her yakınlaştırmada en keskin sonucu istediğinizde PDF olarak kaydet'i kullanın; yazdırma penceresini açmadan ekranda olanın hızlı ve birebir bir kopyasını istediğinizde PDF İndir'i kullanın.

Sorun giderme

Garip yerlerde sayfa sonları. mdprint kod blokları, tablolar ve diyagramların içinde bölmekten kaçınır ama metin için tahminde bulunmaz. Bir başlık bölüm içeriği sonraki sayfadayken sayfanın altına denk düşerse en kolay çözüm başlığı itmek için üstüne ya da altına birkaç cümle eklemektir. V1'de el ile sayfa sonu söz dizimi yoktur - eklenmesi V2 listesindedir.

Görseller PDF'te görünmüyor. En yaygın neden, yerel dosya sisteminize (file://) veya kaynaklar arası erişime izin vermeyen bir sunucuya işaret eden bir görsel URL'sidir. Görseli doğrudan Markdown kaynağına bir veri URL'si olarak gömün ya da herkese açık okuma izni veren bir görsel barındırıcısına yükleyin. Imgur, GitHub'ın kullanıcı içeriği sunucuları ve çoğu CDN çalışır.

Matematik işlenmiyor. Kaynakta normal metinde kaçırılmamış dolar işareti olup olmadığını kontrol edin - başıboş bir $, paragrafın geri kalanını yutan bir matematik aralığını başlatabilir. Metinde gerçek dolar işareti gerekiyorsa kaçırın: \$. Matematik söz dizimi doğruysa ve denklem yine işlenmiyorsa LaTeX komutu KaTeX'in desteklenenler listesinde olmayabilir - KaTeX belgelerinde tam bir referans vardır.

Diyagram boş. Mermaid söz dizimi konusunda katıdır. En yaygın hatalar graph LR'den sonra eksik bir boşluk, boşluk içeren bir düğüm kimliği (camelCase veya alt çizgi kullanın) ya da tanımsız bir düğüme işaret eden bir oktur. Tarayıcınızın geliştirici konsolunu açın - Mermaid ayrıştırma başarısız olduğunda belirli bir hata mesajı yazar.

Tablolar tuhaf sarıyor. Bir tablo sayfadan genişse mdprint sığması için ölçeklendirir. Çok geniş tablolar için Ayarlar'da yatay yöne geçin ya da tabloyu liste olarak yeniden yapılandırın. PDF, web'in yaptığı gibi yatay kaydırma yapmaz.

İpuçları ve püf noktaları

Klavye kısayollarını kullanın. Cmd+P (veya Windows ve Linux'ta Ctrl+P) yazdırma penceresini açar. Cmd+S (Ctrl+S) PDF İndir'i tetikler. Tarayıcının kendi bul (Cmd+F), yeniden yükle (Cmd+R) ve yakınlaştırma (Cmd+artı/eksi) kısayolları normal şekilde çalışır - mdprint ile çakışmaz.

Her belgeye bir H1 ile başlayın. İlk H1, önerilen PDF dosya adı, erişilebilirlik için belge başlığı ve yazdırılan sayfanın üstündeki belirgin başlık olur. H2 veya altıyla başlarsanız dosya adı 'document.pdf'e döner ve indirme sonrası elle yeniden adlandırmanız gerekir.

Gizlilik önemliyse görselleri veri URL'leri olarak gömün. Dosyanızı açtığında bir PDF okuyucunun görselleri uzak bir sunucudan çekmesini istemiyorsanız görseli base64 veri URL'sine dönüştürüp doğrudan gömün. Çoğu işletim sisteminde bu dönüştürme için yerleşik ya da özel bir araç bulunur. Sonuç dosya daha büyüktür ama tamamen kendi içinde tutarlıdır.

Basılı kontrol listeleri için görev listelerini kullanın. Kâğıt bir kontrol listesi üretiyorsanız - bir bavul listesi, bir sevkiyat kontrol listesi, adım adım bir prosedür - - [ ] ile Markdown görev listesi söz dizimini kullanın. Kareler kalemle işaretleyebileceğiniz kutular olarak basılır.

Teknik dokümantasyonda Mermaid ve kodu birleştirin. Yaygın bir örüntü, bir sürecin akış şemasını göstermek, ardından onu uygulayan asıl kodu vermektir. Markdown her ikisini aynı dosyada yapmanıza izin verir ve mdprint, bunları yan yana temiz biçimde basılacak şekilde işler.

Klavye kısayolları

Cmd+P veya Ctrl+P - yazdırma penceresini açar.

Cmd+S veya Ctrl+S - PDF olarak indirir.

Cmd+B veya Ctrl+B düzenleyicide - seçili metni kalın yapar.

Cmd+I veya Ctrl+I düzenleyicide - seçili metni italik yapar.

Cmd+/ veya Ctrl+/ düzenleyicide - geçerli satırın yorumunu açar/kapatır (Markdown bağlamında HTML yorumu).

Düzenleyicide tam ekrandayken Esc - tam ekrandan çıkar.

Markdown ve yazdırma hakkında daha fazlasını öğrenin

Markdown nedir?

Markdown, John Gruber tarafından 2004 yılında oluşturulmuş hafif bir düz metin biçimlendirme söz dizimidir. Ne demek istediğinizi yazarsınız - başlıklar için #, kalın için **, madde imleri için - - ve bir oluşturucu bunu temiz HTML, PDF veya yazdırılmış çıktıya dönüştürür. GitHub, Reddit, Discord ve modern geliştirici araçlarının çoğunda varsayılan yazma biçimine dönüşmüştür çünkü biçimlendirmenin zihinsel yükünü ortadan kaldırır: yazmaya devam edersiniz, yapı kendiliğinden oluşur.

GitHub Flavored Markdown (GFM), özgün şartnameyi tablolar, görev listeleri, çitli kod blokları, otomatik bağlantı ve üzeri çizili ile genişletir. Günümüzde çoğu araç GFM'i ve birkaç yaygın uzantıyı uygular: dipnotlar, KaTeX ile matematik, Mermaid ile diyagramlar ve tanım listeleri. mdprint bunların hepsini kutudan çıktığı gibi destekler.

Bir kelime işlemcide yazmaya kıyasla Markdown, yazdırma için önemli iki avantaj sağlar. Birincisi, kaynak sizin sahip olduğunuz düz bir metin dosyasıdır - sahibine bağlı format yok, başka bir bilgisayarda açıldığında sürpriz yeniden akış yok. İkincisi, aynı kaynak her seferinde tutarlı bir çıktı üretir: aynı başlıklar aynı stili alır, aynı kod blokları aynı tek aralıklı yazı tipini alır, aynı tablolar aynı kenarlıkları alır. Notlar, dokümantasyon, makaleler veya raporlar yazdırırken ihtiyacınız olan tam da bu tutarlılıktır.

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

Üç yaygın yaklaşım vardır. İlki, Pandoc gibi komut satırı araçlarıdır - güçlüdür, ama kurulum, ciddi tipografi için çalışan bir LaTeX kurulumu ve çıktının doğru görünmesi için epey deneme yanılma ister. İkincisi, dosyanızı kontrolünüzde olmayan bir sunucuya yüklemenizi isteyen çevrimiçi dönüştürücülerdir. Bir taslak için sorun olmaz, ama gizli her şey için baştan elenir, ayrıca çoğu birinci sayfadan sonra filigran veya ödeme duvarı ekler.

Üçüncü yaklaşım mdprint'in yaptığı şeydir: her şeyi tarayıcınızda işler. Bir Markdown dosyasını düzenleyiciye yapıştırır veya bırakırsınız, JavaScript bir Markdown ayrıştırıcı bunu HTML'e çevirir, tarayıcı yazdırmaya duyarlı CSS ile işler ve siz ya yerel yazdırma penceresini açarsınız (PDF olarak kaydet modern her işletim sisteminde çalışır) ya da istemci taraflı bir kitaplıkla doğrudan PDF üretirsiniz. Yükleme yok, sunucuya gidiş-dönüş yok, bekleme yok.

Tarayıcı içi yolu tercih etmek için üç neden. Birincisi gizlilik: bir işe alım kararı, vergi beyannamesi veya bir sözleşme taslağı yalnızca PDF'e dönmek için başka birinin sunucusundan geçmek zorunda değildir. İkincisi hız: sayfa yüklendikten sonra dönüştürme anlıktır ve yineleyebilirsiniz - bir başlığı düzeltin, yazdırın, yeniden düzeltin. Üçüncüsü çevrimdışı: mdprint bir kez yüklendikten sonra uçakta veya kurumsal bir güvenlik duvarının ardında hiçbir şey kırılmadan kullanabilirsiniz.

Markdown söz dizimi kopya kâğıdı

Başlıklar: # H1, ## H2, ### H3, ###### H6'ya kadar. Belge başına tam olarak bir H1 kullanın - yazdırılan çıktıda başlık ve PDF dosya adı önerisi olur.

Vurgu: *italik* veya _italik_, **kalın** veya __kalın__, ~~üzeri çizili~~. Gerekirse **_kalın italik_** ile birleştirin.

Listeler: sırasız -, * veya + ile; sıralı 1., 2., 3. ile (sayıların sıralı olması gerekmez - Markdown yeniden numaralandırır). İç içe için iki veya dört boşluk girinti yapın. Görev listeleri işaretsiz için - [ ] ve işaretli için - [x] kullanır.

Bağlantılar ve görseller: bağlantı için [metin](https://example.com), görsel için ![alt metin](image.jpg). [metin][id] biçimindeki referans bağlantılar ve ayrı bir [id]: https://example.com satırı, metni okunabilir tutar.

Kod: satır içi `kod` için geri tırnak, bloklar için isteğe bağlı dil etiketiyle üç geri tırnak. Vurgulayıcının doğru gramerle çalışması için dili belirtin (```python, ```typescript).

Tablolar: dikey çizgi ve tire söz dizimi. Bir satırda | Sütun | Sütun |, sonraki satırda |---|---|, ardından veri satırları. Hizalama işaretleri (:--, --:, :-:), yazdırılan çıktıdaki sütun hizasını belirler.

Matematik: satır içi $E = mc^2$ ile, blok $$ \int_0^\infty e^{-x} dx = 1 $$ ile. mdprint KaTeX kullanır; hızlı işler, net yazdırır.

Diyagramlar: dil etiketi mermaid olan çitli bir kod bloğu, işlenmiş bir SVG diyagrama dönüşür. Akış şemaları, dizi diyagramları, Gantt grafikleri, durum makineleri, sınıf diyagramları - hepsi desteklenir.

Yerel işleme neden önemlidir

Bir belge cihazınızdan her ayrıldığında, tamamen denetleyemeyeceğiniz bir risk eklersiniz. Alıcı sunucu istek gövdesini loglayabilir. Kenardaki TLS proxy'si bunu önbelleğe alabilir. Yükleme sayfasındaki üçüncü taraf analiz betiği dosya adını yakalayabilir. Hata izleme servisi, bir parça içeren yığın izini alabilir. Çoğu zaman bunların hiçbiri olmaz - ama hangi kez kötü kez olduğunu bilemezsiniz ve sonradan geri alamazsınız.

Yerel işleme bu tüm hata sınıfını ortadan kaldırır. mdprint ihtiyacı olan JavaScript'i bir kez indirir, sonra her şeyi tarayıcının kum havuzunda çalıştırır: Markdown ayrıştırıcı, söz dizimi vurgulayıcı, matematik işleyici, diyagram işleyici, PDF üretici. Dosyanız hiç seyahat etmez. İsteseydik bile görebilen bir sunucu çalıştırmıyoruz.

Gizlilik garantisi vaat değil yapısaldır. Yanlış yapılandırılabilecek bir yükleme noktası yok, taslağınızın kazara saklanabileceği bir veritabanı yok, dosyanıza bakması için sosyal mühendislikle kandırılacak bir destek personeli yok. Sızamayacak olan şey, hiç gönderilmemiş olan şeydir.

mdprint diğer araçlarla nasıl karşılaştırılır

Pandoc, komut satırında rahatsanız ve bilimsel ya da kitap uzunluğunda çıktı üretiyorsanız belge dönüştürmenin altın standardıdır. Özel LaTeX şablonlarıyla 300 sayfalık bir el yazması teslim eden bir yazar için doğru araçtır. Bir toplantı notunu veya proje README'sini yazdırmak için fazla kaçar.

Typora ve Obsidian, yerleşik PDF dışa aktarmalı mükemmel Markdown düzenleyicileridir. Markdown günlük yazı yüzeyinizse kurmaya değer. mdprint ise diğer durum içindir: bir kez yazdırmak veya paylaşmak için bir dosyanız vardır ve bunun için hiçbir şey kurmak istemezsiniz.

Markdown'ı PDF'e çeviren tarayıcı eklentileri genellikle içeriği uzak bir servise göndererek çalışır. Bu, mdprint'in var olduğu gizlilik sorununu geri getirir. Dönüştürmenin başka birinin makinesinde gerçekleşmesi gerekiyorsa size mdprint değil, barındırılan bir servis gerekir. Aksi takdirde gerekmez.

Google Docs, Microsoft Word ve Pages, Markdown'u açabilir ancak tutarsız biçimde işler ve kaynağı korumaz. PDF çıktısı iyidir, ama dosyayı her açtığınızda yine sahipli düzenleyiciye kilitlenirsiniz. mdprint kaynağınızı düz metin olarak tutar. Dosyanız sonsuza dek taşınabilir kalır.

FAQ

Sık sorulan sorular

Sorunuz burada yoksa anton@fokuus.be adresine yazın.

Evet. Tamamen ücretsiz, kayıt gerekmez, ödeme duvarı yok, reklam yok. Kamu hizmeti olarak Fokuus tarafından yapılır ve sürdürülür.

mdprint hakkında

mdprint, Markdown'ı PDF'e dönüştürmek için ücretsiz, gizliliği önceleyen bir araçtır. Tamamen tarayıcınızda çalışır - yükleme yok, hesap yok, içerik takibi yok.

Neden var

Çoğu çevrimiçi Markdown-PDF dönüştürücü, dosyanızı bir sunucuya yükleyerek çalışır. Bu, herkese açık bir README için makul bir ödünleşmedir ve bir sözleşme taslağı, vergi belgesi veya herhangi bir çalışma dosyası için kabul edilemez. mdprint, bu ödünleşmenin ortadan kalkması için her şeyi yerel olarak işleyen bu dönüştürücülerin sürümüdür.

Kim yaptı

Fokuus, Belçika merkezli küçük bir web stüdyosudur. mdprint, kendi de istediğimiz bir aracı herkese ücretsiz sunmak için Anton Pycarelle tarafından kamu hizmeti olarak yapıldı. İletişim: anton@fokuus.be.

Nasıl ücretsiz kalıyor

V1'de reklam, ek satış veya premium katman yok. Barındırma esasen ücretsizdir (Netlify üzerinde statik dosyalar), dolayısıyla geri kazanılacak bir şey yok. İleride ücretli özellikler eklersek bunlar ek nitelikte olacak - temel araç ücretsiz kalır.

Yol haritası

V1, 18 dilde Markdown'dan PDF'e tüm akışı kapsar. V2 listesinde HTML dışa aktarma, DOCX dışa aktarma, bir şablon galerisi ve özel tema düzenleyici bulunur. Açık kaynak da V2 listesindedir.

Düzenleyiciyi aç

Hesap, kurulum veya yükleme yok. Yukarı kaydırın ve yazmaya başlayın.

mdprint