Sol tarafa Markdown yazın ya da yapıştırın, sağda HTML olarak nasıl göründüğünü yazdıkça anında görün. Başlıklar, kalın ve italik metin, listeler, tablolar, alıntılar ve kod blokları hemen işlenir; GitHub Flavored Markdown’ın tablo ve üstü çizili metin gibi ekleri de dahildir.

Canlı önizleme nasıl çalışıyor?

Ayrıştırma, GFM desteği açık marked kütüphanesiyle yapılır; bu sitenin Markdown’dan HTML’e dönüştürücüsünün arkasındaki aynı ayrıştırıcıdır. Her tuş vuruşu girdinin tamamını yeniden ayrıştırır ve önizleme bölmesini yeniden çizer, ayrı bir “işle” adımı veya tıklanacak bir buton yoktur; bir başlık yazmakla sağda görünmesi arasında gecikme olmaz. HTML sayfaya dokunmadan önce, güvenilmeyen HTML’den tehlikeli işaretlemeyi ayıklamak için özel olarak yazılmış bir kütüphane olan DOMPurify ile temizlenir. Bu sayede yapıştırılan içerik önizleme üzerinden bir script etiketi veya onerror işleyicisi çalıştıramaz; bu da önemlidir çünkü Markdown doğrudan ham HTML eklemenize izin verir, aksi hâlde bu ham HTML olduğu gibi işlenirdi.

Yazdığım bir şey sunucuya gönderiliyor mu?

Hayır. Ayrıştırma, işleme ve temizleme sayfaya gömülü JavaScript ile tamamen tarayıcınızda gerçekleşir. Yazdığınız metin makinenizden hiç çıkmaz; bu, yayınlanmamış taslaklar, içinde özel bir şey olan notlar veya henüz hiçbir yere kaydetmeye hazır olmadığınız bir belge için önemlidir. Sunucuya hiçbir şey gönderilmediği için silinecek bir geçmiş de yoktur. Sekmeyi kapatmanız yeterli.

Bu ne işe yarar?

Bir README’yi kaydetmeden önce nasıl görüneceğini kontrol etmek, GitHub veya GitLab’a göndermeden önce bir yorumu veya issue metnini önizlemek ya da Markdown’ı sizin için işleyen bir platforma göndermeden bir tablonun sütun hizalamasını gözden geçirmek için kullanabilirsiniz. Ayrıca bir Markdown dosyasına yapıştırılmış gömülü bir <iframe> veya stilli bir <div> gibi ham bir HTML bloğunun beklediğiniz gibi göründüğünü hızlıca kontrol etmenin ya da iç içe bir listenin herhangi bir yerde yayınlanmadan önce doğru girintilenip girintilenmediğini görmenin de pratik bir yoludur.

Temel söz dizimi için CommonMark spesifikasyonuna, tablo ve üstü çizili metin uzantıları için GitHub’ın GFM spesifikasyonuna, temizleme adımının nasıl çalıştığı hakkında daha fazlası için DOMPurify projesine bakabilirsiniz.