Markdown'dan HTML'e

Nasıl çalışır?

Metni sol alana yazın ya da yapıştırın; çıktı yazdıkça sağda oluşur. Çevirme işini olgun bir Markdown ayrıştırıcısı yapar, yani bu araç yaygın yazımın tamamını tanır: birden altıya kadar başlık, kalın ve italik, üstü çizili, satır içi kod ve çitli kod bloğu, iç içe listeler, görev listesi (köşeli parantez içinde boşluk ya da x), tablo, alıntı, görsel, yatay çizgi ve adresi olduğu gibi yazılmış bağlantılar. Metninizin içinde hazır HTML varsa o da korunur, ama önce bir güvenlik süzgecinden geçirilir: betik etiketleri, olay öznitelikleri ve tıklandığında kod çalıştıran adresler atılır, geriye içeriğinizin kendisi kalır. Sonuç satırı ne bulduğunu sayar ve bir şey atıldıysa kaçını attığını söyler. İki çıktı biçiminden birini seçebilirsiniz: gövde HTML'i var olan bir sayfanın içine yapıştırılır, tam sayfa seçeneği ise tek başına açılabilen bir dosya üretir.

Bu araç markdown to html, markdown tablo html, markdown converter aramalarıyla da biliniyor.

Markdown işaretleri nedir?

Markdown'da biçim, etiketle değil satırın başındaki ya da metnin çevresindeki noktalama işaretleriyle anlatılır: diyez sayısı başlık düzeyini verir, çift yıldız kalın yapar, tek yıldız italik, ters tırnak kod olduğunu söyler, büyüktür işaretiyle başlayan satır alıntıdır. Bu yazım bir uzlaşıdır, tek bir resmî standardı yoktur; işleyiciler çekirdekte anlaşır, ayrıntıda ayrışır.

GFM (GitHub biçimli Markdown) nedir?

GFM, Markdown'ın en yaygın kullanılan lehçesidir ve temel yazımın üstüne dört ek getirir: boru işaretiyle çizilen tablolar, köşeli parantezli görev listeleri, iki yaklaşık işareti arasına alınan üstü çizili metin, bir de yazının içinde geçen adresin kendiliğinden bağlantıya dönüşmesi. Bugün yazılan Markdown'ın büyük bölümü bu lehçededir; bu araç da onu tanır.

HTML temizleme (sanitization) nedir?

HTML temizleme, bir HTML parçasını sayfaya koymadan önce içindeki tehlikeli parçalardan arındırmaktır: betik etiketleri, tıklama veya yükleme olaylarına bağlanan öznitelikler, çerçeve içine yabancı sayfa gömen etiketler ve kod çalıştıran adresler atılır, geri kalan yapı korunur. Kaçırmadan farkı şudur: kaçırma her şeyi metne çevirir, temizleme ise güvenli etiketleri etiket olarak bırakır.

Gövde HTML'i nedir?

Gövde HTML'i, bir sayfanın yalnızca içerik kısmını oluşturan etiketlerdir: başlıklar, paragraflar, listeler, bağlantılar. Doctype bildirimi, head bölümü, karakter kümesi ve stil bağlantıları bu parçanın dışındadır; çünkü onlar sayfanın iskeletine aittir. İçerik yönetim sistemlerine, e-posta şablonlarına ve blog editörlerine yapıştırılacak metin genelde bu biçimde istenir.

Markdown ile HTML arasındaki fark nedir?

İkisi de aynı işi yapar — metne yapı kazandırır — ama farklı taraflara hitap eder. Markdown insana bakar: işlenmeden de okunur, hızlı yazılır, sürüm takibinde temiz görünür. HTML tarayıcıya bakar: her öğe açık bir etikettir, öznitelik alır, sınırsız derinlikte yapı kurar. Markdown'ın hemen her yerde çalışmasının nedeni de budur; sonunda bir yerlerde HTML'e çevrilir. Bu araç o son adımı, arada bir sunucuya uğramadan yapar.

Hangi Markdown yazımı tanınıyor?

Temel CommonMark yazımının üstüne GitHub'ın yaygınlaşan eklerini de tanır. Aşağıdaki liste sık kullanılanları toplar; listede olmayan bir işaret düz metin olarak çıkar, sessizce kaybolmaz.

Satır sonları bilinçli olarak paragrafı bölmez: bir paragrafın içinde alt alta yazdığınız satırlar tek paragraf olur, yeni paragraf için aralarında boş satır bırakırsınız. E-postadan ya da not defterinden yapıştırılan metnin parçalanmamasının sebebi budur.

• Başlıklar, kalın, italik, üstü çizili (~~böyle~~)
• Satır içi kod ve dil adı yazılabilen kod bloğu
• İç içe sırasız ve sıralı listeler; görev listesi
• Boru işaretiyle çizilen tablolar, hizalama satırıyla birlikte
• Alıntı, yatay çizgi, görsel, dipnotsuz bağlantı
• Yazının içine adresini yazdığınız bağlantı kendiliğinden tıklanır olur

Metninizdeki HTML'e ne oluyor?

Markdown'ın kendi tanımı, arasına HTML yazılabilmesine izin verir; bir açılır kutu (details), klavye tuşu (kbd) ya da elle çizilmiş bir tablo genelde böyle yazılır. Bu araç onları korur, ama önce olgun bir temizleyiciden geçirir.

Süzgeç, tarayıcıya kod çalıştırtabilecek her şeyi atar: betik etiketleri, çerçeve içine sayfa gömen etiketler, tıklama ve yükleme olaylarına bağlanan öznitelikler, kod çalıştıran adresler. Yanı sıra iki etiket daha bilinçli olarak elenir: stil bloğu ve form. Gövde HTML'i başka bir sayfanın içine yapıştırıldığı için oraya sızan bir stil bloğu tüm sayfayı yeniden boyar, bir form ise sahte bir giriş kutusuna dönüşebilir.

Bir şey atıldıysa sonuç satırında kaç öğenin temizlendiği yazar. Böylece çıktıyı gözünüzle karşılaştırmadan da metninizden bir şeyin düştüğünü öğrenirsiniz.

Bağlantı adresleri nasıl süzülüyor?

Adresin başındaki şema (adresin iki nokta üst üsteden önceki kısmı) denetlenir. Web adresleri, e-posta, telefon, kısa mesaj ve dosya sunucusu adresleri geçer; tıklandığında kod çalıştıran adresler ise sessizce düşer ve bağlantı adressiz kalır.

Göreli adresler serbesttir: eğik çizgiyle başlayan bir yol, aynı klasördeki bir dosya adı ya da sayfa içi çapa geçerli sayılır. Çıktıyı kendi sitenizin içine yapıştıracaksanız ihtiyacınız olan tam da budur.

Bağlantıya kendiniz bir hedef yazdıysanız (yeni sekmede açılsın gibi) o da korunur; güncel tarayıcılar bu tür bağlantıları zaten yalıtarak açar.

Gövde mi, tam sayfa mı?

Gövde çıktısı yalnızca içerik etiketlerini verir: bunu var olan bir şablonun, bir içerik yönetim sisteminin ya da e-posta gövdesinin içine yapıştırırsınız.

Tam sayfa seçeneği doctype bildirimi, dil özniteliği, karakter kümesi ve görüntü alanı etiketi olan çalışır bir HTML dosyası üretir. Sayfa başlığı, metindeki ilk birinci düzey başlıktan alınır; başlık yoksa yerine genel bir ad yazılır.

Sık sorulanlar

Metnimdeki HTML etiketleri korunuyor mu?

Evet, ama süzgeçten geçerek. Kendi yazdığınız açılır kutu, klavye tuşu ya da tablo etiketleri çıktıda etiket olarak kalır; betik, çerçeve, olay öznitelikleri ve kod çalıştıran adresler atılır. Kaç öğenin atıldığı sonuç satırında yazar.

Tabloları da çeviriyor mu?

Evet. Boru işaretiyle çizilmiş tablolar başlık satırı ve hizalama satırıyla birlikte gerçek tablo etiketlerine çevrilir. Tablo verisi elinizde CSV olarak duruyorsa önce CSV'den Markdown tablosuna aracını kullanmak işinizi kısaltır.

İç içe listeler korunuyor mu?

Evet. Alt maddeleri girintili yazdığınız sürece derinlik olduğu gibi çıkar; girinti için iki ya da dört boşluk kullanmanız yeterlidir. Görev listesi maddeleri de işaretli veya işaretsiz kutu olarak çıkar.

Kod bloğundaki karakterler bozulur mu?

Hayır. Kod bloğunun ve satır içi kodun içeriğine biçimlendirme uygulanmaz; açılı parantezler kod etiketinin içinde metne çevrildiği için tarayıcıda yazdığınız gibi görünür. Açılış çitine dil adı yazarsanız çıktıdaki etikete o dilin sınıfı eklenir.

Metnim bir yere gönderiliyor mu?

Hayır. Çeviriyi ve güvenlik süzgecini tarayıcınızın içinde çalışan iki kütüphane yapar; yapıştırdığınız metin hiçbir sunucuya gitmez.