Markdown dosyaları: kuralları olan düz metin — ve birden fazla türü var
Bir .md dosyası nedir, işleyiciler neden onda anlaşamaz ve başlıkları hiç kaydetmemiş bir PDF’den başlık ve listeler nasıl kurulur. Tarayıcınızda dönüştürün.
Bir bakışta
- Tür
- Belgeler
- Uzantılar
- .md, .markdown
- MIME türü
- text/markdown
- Diğer adları
- MD
Bir .md dosyası bir metin dosyasıdır. Kapsayıcı yoktur, sıkıştırma yoktur, içinde ikili hiçbir şey yoktur — Not Defteri’nde açtığınızda tuttuğu her şeyi olduğu gibi görürsünüz. Biçimlendirme bir işaretleme değil, bir gelenektir: satır başındaki # bir başlık, bir kısa çizgi bir liste öğesi anlamına gelir ve bu geleneği anlayan bir işleyici bunları HTML’e dönüştürür. Bütün fikir budur; biçimin kendi kuşağındaki her zengin metin düzenleyicisinden daha uzun ömürlü olmasının nedeni de budur: dosya, herhangi bir şey onu işlemeden önce okunabilirdir ve onu yazdığınız araç ortadan kalktığında da okunabilir kalacaktır.
Devamını oku
İşin karmaşık yanı, tek bir Markdown’ın olmamasıdır. 2004’teki özgün uygulama pek çok durumu tanımsız bıraktı, bu yüzden her işleyici bunları farklı biçimde çözdü; CommonMark bu belirsizlikleri netleştirmek için vardır, GitHub Flavored Markdown ise bunun üzerine tablolar, görev listeleri ve üstü çizili metin ekler. Bu durum resmî olarak da kabul edilmiştir: text/markdown, Mart 2016’da RFC 7763 ile bir medya türü olarak kaydedildiğinde kayda bir variant parametresi eklendi; çünkü bir dosyanın Markdown olduğunu söylemek, hangi Markdown olduğunu söylemez. Bu sitenin ürettiği, UTF-8 ile text/markdown’dır ve yalnızca her lehçenin üzerinde anlaştığı yapıları kullanır — diyez başlıklar, boş satırla ayrılmış paragraflar, kısa çizgili madde işaretleri ve yatay çizgiler.
Bir PDF’yi Markdown’a dönüştürmek, PDF’de hiç olmamış bir yapıyı üretmek demektir. PDF başlıkları değil, yazı boyutlarını kaydeder; bu yüzden sayfadaki boyutlar sıralanır ve en büyük altısı altı başlık düzeyine dönüşür; gövde metninden yalnızca daha büyük olan bir satır, yazar onu başlık olarak düşünmüş olsun ya da olmasın başlık olur. Listeler daha da kötüdür: PDF’de hiçbir liste yapısı yoktur ve gördüğünüz madde işareti kelimenin tam anlamıyla metindeki bir karakterdir; dolayısıyla bir listenin korunmasının tek yolu o karakteri tanıyıp bir kısa çizgi olarak yeniden yazmaktır. Numaralı öğelerin böyle bir yardıma ihtiyacı yoktur — "1. " ve "1) " zaten Markdown’dır ve zaten bir liste olarak kastedilmiştir.
İki ayrıntıyı bilmekte fayda var, çünkü metnin kendisini değiştirirler. Kısa çizgiyle biten bir satır, satır sonunda bölünmüş bir sözcük olarak kabul edilir ve çizgi olmadan yeniden birleştirilir; ardışık Çince ya da Japonca satırlar ise aralarına boşluk konmadan birleştirilir, çünkü bu yazı sistemleri oraya boşluk koymaz. Sayfalar yatay bir çizgiyle ayrılır; bu yüzden on üç sayfalık bir belge on iki çizgiyle gelir. PDF metin katmanı olmayan bir taramaysa, PDF’den Word’e dönüştürmede kullanılan tanıma modeli önce karakterleri sayfa görüntülerinden, kendi cihazınızda okur.
Diğer formatları Markdown formatına dönüştürün
Markdown SSS
Bir .md dosyası yalnızca bir metin dosyası mıdır?
Evet. Kapsayıcı yok, sıkıştırma yok, ikili hiçbir şey yok. Her metin düzenleyicisi onu açar ve işaretler — #, -, ** — olduğu gibi okuyabileceğiniz sıradan karakterlerdir.
Hangi Markdown türünü elde ederim?
Yalnızca her lehçenin üzerinde anlaştığı kısımları: diyez başlıklar, boş satırlarla ayrılmış paragraflar, kısa çizgili madde işaretleri ve yatay çizgiler. Buradaki hiçbir şey GitHub ya da CommonMark uzantısına dayanmaz; bu yüzden nereye yapıştırırsanız yapıştırın aynı biçimde görüntülenir.
Belgemin içinden neden kesik çizgilerden oluşan satırlar geçiyor?
Bunlar sayfa sonlarıdır. Her biri, bir PDF sayfasının nerede bittiğini ve bir sonrakinin nerede başladığını gösteren yatay bir çizgidir; bu yüzden on üç sayfalık bir belge on iki çizgiyle geri gelir.
Bir başlık yanlış düzeyde çıktı. Neden?
Düzeyler yazı boyutuna göre sıralanır, çünkü bir PDF başlıkları değil boyutları saklar. Bir belgenin boyutu hiyerarşi için değil vurgu için kullandığı yerlerde — öne çıkarılmış bir alıntı, büyük yazılmış bir ilk satır — sıralama boyutu izler ve düzeyi yanlış belirler.
Tablolar korunur mu?
Çizgilerle çizilmiş tablolar korunur — ilk satır başlık olacak şekilde Markdown tabloları olarak çıkarlar. Taranmış bir sayfadaki tablolar sıradan satırlar olarak çıkar, çünkü bir taramada okunacak çizgi yoktur. Dönüştürmenin tek nedeni tablolarsa, PDF’den Excel’e dönüştürme her birini üzerinde çalışabileceğiniz satır ve sütunlara yerleştirir.
Taranmış PDF’lerde çalışır mı?
Evet. Metin katmanı olmadığında tarayıcınızda bir yapay zekâ tanıma modeli çalışır ve karakterleri sayfa görüntülerinden okur. Bu durumda başlıklar yazı tipi boyutuna göre değil, ölçülen satır yüksekliğine göre sıralanır ve hiçbir şey yüklenmez.