Markdown’dan düz metne veya biçimli metne

Markdown’ı yapıştır, Düz metin’i seç ve söz dizimi karakterleri kaybolsun: kalın yazının etrafında ** yok, başlıkların önünde # yok, kodun etrafında ters tırnak yok. Geriye bir e-postaya, iş başvuru formuna, destek kaydına veya sohbete koyabileceğin karakterler kalır.

Asıl önemli olan neyin hayatta kaldığı. Numaralı listeler numaralarını korur; 7’den başlayanlar ve başka listelerin içine yerleşenler de dahil. İç içe maddeler girintisini korur. Paragraf araları koyduğun yerde kalır. Tablolar tek satıra çökmek yerine boşluklarla hizalanmış sütunlara dönüşür. Başlık, tanıttığı metnin hemen üstünde durur, boş bir satırla ondan ayrılmaz.

Çoğu dönüştürücü ilk yarıyı doğru, ikinci yarıyı yanlış yapar; çünkü yaygın kütüphaneler listeyi süs sayıp düzleştirir. Numaralandırma çoğu zaman belgenin en önemli yapısıdır — okura hangi yanıtın hangi soruya ait olduğunu söyleyen şeydir — bu yüzden burada atılmak yerine korunur.

Hedef bir belgeyse düz metin yanlış cevaptır. Biçimli metin’i seç ve Kopyala’ya bas: panoya biçimli sürüm, yanında düz metin yedeğiyle birlikte gider. Microsoft Word’e, Google Docs’a, Gmail’e veya Outlook’a yapıştır; başlıklar gerçek başlık, listeler gerçek liste olur ve tabloların gerçek hücreleri olur.

Bu, tek bir kopyalamanın aynı içeriği aynı anda birden fazla biçimde taşıyabilmesi sayesinde çalışır. Yapıştırdığın uygulama anladığı biçimi seçer — aynı kopyalama bu yüzden Word’e biçimli, terminale okunabilir metin olarak gider. Hiçbir şey kaybolmaz: iki sürüm birlikte yolculuk eder.

Firefox, birden çok biçim yazan pano API’sini kısıtlar; orada önizleme senin için seçilir ve sıradan bir Ctrl+C biçimi de alır. Görseller veri olarak değil başvuru olarak yolculuk eder, dolayısıyla adreslerine erişilebilen yerlerde görünürler.

İşaretlemenin kendisini almak için HTML kaynağı’nı seç — anlamsal <h2>, <ul>, <table> ve <pre> öğeleri — bir CMS’e, şablona veya e-posta düzenleyicisine yapıştırmaya hazır. Bir önizleme düğmesi bitmiş belgeyi gösterir, böylece kopyalamadan önce kontrol edebilirsin.

HTML gösterilmeden ya da verilmeden önce temizlenir: betik etiketleri, satır içi olay işleyicileri ve javascript: adresleri kaldırılır. Bunun önemi, girdinin başka bir yerden yapıştırdığın şey olması ve sayfanın içinde canlı olarak işlenmesidir.

Aynı çıktı, stilleri satır içine yazılmış bağımsız bir .html dosyası olarak iner; böylece herhangi bir bilgisayarda, çevrimdışıyken ve endişelenecek ayrı bir stil dosyası olmadan düzgün açılır.

PDF olarak kaydet’e bas; biçimli belge tarayıcının yazdırma penceresine gider, orada hedef “PDF olarak kaydet”tir. Sayfa fotoğraflanmak yerine yazdırılır, dolayısıyla ortaya çıkan dosyadaki metin seçilebilir, aranabilir ve kopyalanabilir kalır — üstelik dosya küçük kalır.

Açık ya da koyu, pencerede seçtiğin kâğıtta. Koyu mod, diğer renklere dokunmadan sayfayı siyah kâğıt ve beyaz mürekkebe çevirir. Her sayfada yinelenen, belge başlığını ve yazdırma saatini taşıyan bir üst ve alt bilgi ayarlayabilirsin.

Bunu üretmek için hiçbir şey yüklenmez. Sunucuda işleyen her çevrimiçi Markdown-PDF hizmetinin sunucusunda senin belgen durur; bunun ise gönderecek bir sunucusu yok.

Hepsi bu: Markdown’ı ücretsiz ve çevrimiçi olarak PDF’e çevirmek için belgeyi yapıştır ve düğmeye bas. Yükleme adımı yok, sıra yok, filigran yok, kayıt yok, dosya sınırı yok — ki insanlar ücretsiz bir Markdown-PDF dönüştürücü ararken aslında çoğunlukla bunları soruyor.

Kendi bilgisayarında Markdown’ı PDF’e çevirmenin bilinen üç yolu var ve üçü de iyi — farklı işler için. Bir şey kurmadan önce hangisini istediğini bilmekte fayda var.

Markdown PDF gibi bir VS Code eklentisi, zaten editörde yaşıyorsan ve sürekli dosya dönüştürüyorsan doğru cevaptır. İlk seferde kendi Chromium kopyasını indirir, açık dosya üzerinde çalışır ve bir tuşa bağlanabilir. Bedeli birkaç yüz megabayt ve dışına çıkamadığın bir editördür.

pandoc üçünün en yeteneklisidir ve akademik yazım için standart tercihtir: atıflar, çapraz göndermeler, kaynakçalar, numaralı şekiller ve kendi şablonların. PDF çıktısı için bir LaTeX motoruna yaslanır, dolayısıyla ayrıca bir TeX dağıtımı gerekir — tamamı birkaç gigabayt. Tez ya da makale üretiyorsan bu bedeli öde; yanına yaklaşan yok.

Bir Python hattı — HTML için markdown ya da markdown2, ardından PDF için WeasyPrint — dönüştürmeyi insanın değil bir programın yaptığı durumun cevabıdır: gecelik raporlar, üretilen faturalar, bir klasördeki yüz dosya. Programlanabilir ve tekrarlanabilirdir, ama tek bir belge için kurmak iştir.

Bu sayfa dördüncü durum için, ki aynı zamanda en sık karşılaşılanı: tek bir belgen var, PDF’i şimdi istiyorsun ve hiçbir şey kurmamayı tercih ediyorsun. Yapıştır, PDF olarak kaydet’e bas, bitti — tarayıcısı olan herhangi bir bilgisayarda, yönetici izni olmadan, paket yöneticisi olmadan. Sayfa yakalanmak yerine yazdırıldığı için dosyadaki metin seçilebilir kalır; bu da VS Code eklentisinin kullandığı mekanizmanın aynısıdır.

Mermaid diyagramları ikisinin arasında kalır. Bir ```mermaid bloğu biçimli görünümde gerçek bir diyagram olarak çizilir, dolayısıyla bir akış şemasını hiçbir şey kurmadan burada okuyup gözden geçirebilirsin. PDF ve .html indirmesi Markdown’dan ayrıca kurulur ve orada diyagram kaynak metni olarak kalır. Dışa aktarılan dosyanın içinde çizili olması gerekiyorsa, bu tam olarak Mermaid eklentili VS Code eklentisinin ya da pandoc’un yanındaki mermaid-cli’nin işidir.

Tek istediğin bir Markdown dosyasını okumaksa — birinin gönderdiği bir README, .md olarak dışa aktarılmış notlar, bir değişiklik listesi — masaüstü uygulamasına ihtiyacın yok. Dosyayı girdi paneline bırak ya da “URL’den” alanına bir GitHub veya GitLab bağlantısı yapıştır ve çıktıyı Biçimli metne al. O panel belgenin işlenmiş hâlidir: gerçek başlıklar, gerçek listeler, gerçek tablolar, kendi adreslerinden yüklenen görseller.

Bir web sayfası olduğu için aynı şey macOS, Windows, Linux ve ChromeOS’ta her biri için ayrı bir indirme olmadan çalışır ve güncel tutulacak bir sürüm yoktur. Göstermek için hiçbir şey yüklenmez — dosyayı kendi tarayıcın okur ve dosya bilgisayarında kalır.

Ne olmadığı konusunda açık olalım: bu bir dönüştürücü ve görüntüleyicidir, Markdown editörü değil. Dosya ağacı yok, diske kaydetme yok, imleç kaynakta dururken iki panelde yazma yok. Girdi paneline Markdown yazıp sonucun değiştiğini görebilirsin ve metnin ziyaretler arasında hatırlanır — ama uzun bir belge yazacaksan gerçek bir editör istersin, dönüştürecek ya da okuyacaksan doğru yerdesin.

Markdown, biçimli metni sıradan karakterlerle yazmanın bir yoludur. Bir kelimeyi yıldızlarla çevrele, kalın demektir; satıra kare işaretiyle başla, başlık demektir; satırı girintile, iç içe öğe demektir. Kaynağın herhangi bir şey onu işlemeden önce bile okunabilir kalması için tasarlandı ve bu yüzden README dosyalarının, belgelerin, not uygulamalarının ve — burada en önemlisi — yapay zekâ asistanlarının çıktısının standardı oldu.

Sorun şu ki Markdown bir kaynak biçimidir. Ancak bir program onu işlediğinde biçime dönüşür. Asistanının sohbet penceresi onu işler. E-posta programın işlemez; çoğu web formu, hesap tablosu hücresi, destek kaydı alanı ve sohbet kutusu da işlemez. Oralarda söz dizimi harfi harfine noktalama olarak gelir.

Dolayısıyla dönüştürme, içinde gerçek kararlar barındıran bir çeviridir: hiçbir şey onu başlığa çeviremiyorken bir başlık nasıl görünür? Hücre yokken bir tablo nasıl görünür? Bu soruların tek bir doğru yanıtı yok; bu yüzden bu araç onları ayar olarak açığa çıkarır ve metnin genellikle gittiği yerlere göre profillerde gruplar: bir e-posta, bir rapor, bir sohbet mesajı, bir belge sayfası, bir web formu.

Tamamen tarayıcında, CommonMark artı GitHub uzantılarıyla çalışır — tablolar, üstü çizili, görev listeleri, otomatik bağlantılar ve dipnotlar — dolayısıyla dönüştürme anlıktır, sayfa yüklendikten sonra çevrimdışı çalışır ve metnini hiçbir yere göndermez.