Markdown Önizleme
Markdown metninizi yazarken işlenmiş hâliyle görün; tarayıcınızda, tüm ham HTML çalıştırılmak yerine kaçışlanarak.
Tamamen tarayıcınızda çalışır. Hiçbir şey yüklenmez, günlüğe yazılmaz veya saklanmaz.
Bunun ürettiği HTML
Solda Markdown yazın, sağda okuyun. Her şey tarayıcınızda olur; dolayısıyla henüz kimseye göstermek istemediğiniz bir taslağın önce bir sunucuya gösterilmesi gerekmez.
Nasıl çalışır
Belge satır satır bloklar hâlinde okunur (başlıklar, paragraflar, listeler, alıntılar, kod, tablolar); ardından her bloğun metni satır içi öğeler için okunur: vurgu, kod parçaları, bağlantılar ve görseller. İşleyicinin tanımadığı her şey metin olarak kalır.
Ham HTML geçirilmek yerine kaçışlanır. Bir etiket yazarsanız etiketi görürsünüz. Bu, seçilmiş bir alt kümeye izin veren çoğu işleyiciden bilinçli bir sapmadır; nedeni de o alt kümeyi doğru seçmenin, çok daha büyük projelerde tekrar tekrar yanlış gitmiş bir iş olmasıdır.
Bir bağlantı yalnızca adresi kısa bir listedeki bir şemayla başlıyorsa oluşturulur; bu kontrol, yazılan hâli üzerinde değil, adresin çözülmüş hâli üzerinde yapılır. Bağlantı reddedildiğinde metin kalır, bağlantı kalmaz; böylece orada bir şey olduğunu görebilirsiniz.
Örnekler
| Durum | Girdi | Sonuç |
|---|---|---|
| Vurgu ve satır içi kod | **bold**, *italic* and `code`. | <p><strong>bold</strong>, <em>italic</em> and <code>code</code>.</p> |
Sık sorulan sorular
Belgem bir yere gönderiliyor mu?
Hayır. İşleyici, bu sayfada çalışan JavaScript’tir. Hiçbir şey yüklenmez, kaydedilmez ya da saklanmaz: ağ bağlantısını kesebilirsiniz, araç çalışmaya devam eder.
HTML kodum neden metin olarak görünüyor?
Çünkü bilerek kaçışlanıyor. Markdown bir belgenin HTML içermesine izin verir ve bu HTML’yi geçirmek, hangi etiketlerin ve özniteliklerin güvenli olduğuna karar vermek demektir; bu ince bir karardır, tarayıcılar değiştikçe değişir ve çok daha fazla kaynağa sahip projeler bunda birden fazla kez başarısız olmuştur. Her şeyi kaçışlamanın böyle bir başarısızlık biçimi yoktur. Bedeli, satır içi HTML’ye dayanan bir belgenin GitHub’daki gibi görünmemesidir; yapılan tercih budur.
Tam olarak CommonMark mı?
Hayır, ve öyle demek yanıltıcı olur. Bir alt kümedir; artı GitHub sürümünün tabloları, görev listeleri ve üstü çizili metni. Başlıkları, paragrafları, vurguyu, kod parçalarını ve kod bloklarını, bağlantıları, görselleri, iç içe listeleri, alıntıları ve yatay çizgileri kapsar. Referans bağlantıları, dipnotlar ve HTML blokları uygulanmamıştır.
Uzak görseller neden görünmüyor?
Çünkü bu sayfa kendine başka sitelerden görsel yükleme izni vermez. Birini indirmek, o sunucuya bu belgeyi okuduğunuzu ve saatini bildirirdi; yerel bir önizlemenin önlemek için var olduğu sızıntı tam da budur. Görsel etiketi çıktı HTML’sinde yer alır, yani yapıştırdığınız yerde çalışır: yalnızca buradan tetiklenmez.
javascript:… gibi bir bağlantıya ne olur?
Bağlantıya dönüşmez. Şema kısa bir listeyle karşılaştırılır (http, https, mailto, tel, ftp ya da göreli bir yol için hiç şema olmaması) ve kontrol çözülmüş adres üzerinde yapılır, çünkü tarayıcı bir öznitelikteki varlıkları ona göre davranmadan önce çözer. Bağlantı metni görünür kalır; böylece orada ne olduğunu görebilirsiniz.
Bilmekte fayda var
- Önizlemenin gösterdiği HTML, aracın size verdiği HTML’dir. Tek bir çıktı vardır; göstermek için güvenli bir tane ve kopyalamak için başka bir tane yoktur.
- Başlıklara id özniteliği verilmez. Belgenizden alınan bir id bu sayfanın id’leriyle aynı ad alanını paylaşırdı ve bir çakışma, önizlemeyi çevreleyen sayfayı bozardı.
- Başka sitelere giden bağlantılar rel="nofollow noopener noreferrer" taşır; böylece buradan açılan bir sayfa bu sayfa üzerinde hiçbir denetim elde etmez.