Nasıl kullanılır?
- Düzenleyiciye Markdown yazın veya tablo ve görev listesi içeren bir belge yüklemek için “Bir örnek dene”ye basın.
- Yazarken önizlemenin güncellenmesini izleyin. Oluşturulan işaretlemeyi görmek için “HTML kaynağı” görünümüne geçin.
- Metnin yayınlanacağı yere uygun olması için GitHub Flavored Markdown'ı veya tek satır sonlarını açıp kapatın.
- HTML'yi bir CMS'ye veya e-postaya kopyalayın ya da sonucu .html veya .md dosyası olarak indirin.
Nasıl çalışır?
Markdown, CommonMark belirtimine ve GFM seçeneği açıkken GitHub Flavored Markdown'a uyan, yaygın olarak kullanılan açık kaynaklı bir ayrıştırıcı olan marked ile dönüştürülür. Buna sütun hizalamalı dikey çizgi tabloları, görev listeleri, ~~üstü çizili metin~~ ve yalın URL'ler için otomatik bağlantılar dahildir. Dipnotlar, matematik ifadeleri ve Mermaid diyagramları bu belirtimlerin parçası değildir ve düz metin olarak gösterilir.
Markdown ham HTML içerebilir ve çoğu Markdown görüntüleyicisinde olduğu gibi bu HTML değiştirilmeden aktarılır. Güvenliğiniz için önizleme bu sayfaya hiçbir zaman eklenmez. Komut dosyalarını çalıştırmasına, form göndermesine, açılır pencere açmasına veya bu siteye erişmesine izin verilmeyen yalıtılmış bir çerçevede görüntülenir; içerik güvenlik ilkesi de komut dosyalarını, harici stil sayfalarını, yazı tiplerini ve çerçeveleri engeller. Markdown içindeki bir <script> etiketi veya onclick özniteliği HTML kaynak kodunda gösterilir ancak çalıştırılmaz. Önizlemedeki bağlantılar gösterilir fakat açılmaz; bağlantıyı takip etmek için URL'yi kopyalayın.
Önizlemede yaygın README görüntüleyicilerine benzer, sade bir stil kullanılır; web siteniz veya GitHub aynı HTML'yi farklı biçimlendirebilir. Kopyalanan HTML, stil içermeyen temel parçadır; indirilen .html dosyasına ise önizlemedeki gibi görünmesi için temel bir stil sayfası eklenir. İndirilen veya kopyalanan HTML temizlenmez; içinde komut dosyaları varsa yapıştırdığınız ya da açtığınız yerde çalışırlar.
Örnekler
Göndermeden önce README'yi kontrol etme
Dosyayı GitHub'a göndermeden önce README.md dosyasını yapıştırarak tablo sütunlarının hizasını, görev listesinin onay kutuları olarak görüntülenmesini ve kod bloklarının doğru şekilde ayrılmasını kontrol edin.
HTML kabul eden bir CMS için içerik yazma
Bir blog yazısını Markdown ile hazırlayın, ardından “HTML'yi kopyala”ya basıp <h2>, <p> ve <ul> etiketlerini CMS'nin HTML düzenleyicisine yapıştırın.
Sohbet tarzı satır sonları
Bir sohbet uygulamasından alınan metinde satırlar tek satır sonlarıyla ayrılmıştır. “Tek satır sonlarını <br> olarak işle” seçeneğini açarak bu satırların tek bir paragrafta birleşmesini önleyin.
Sık sorulan sorular
Kaynağı bilinmeyen Markdown'ı yapıştırmak güvenli mi?
Evet, önizleme için güvenlidir. Oluşturulan HTML, komut dosyalarının devre dışı olduğu yalıtılmış bir çerçevede gösterilir; bu nedenle metindeki <script> etiketi veya olay işleyicisi burada çalışmaz. Dışa aktarılan HTML temizlenmediğinden, onu yapıştıracağınız yere dikkat edin.
Görsellerim neden görünmüyor?
Önizlemenin ağ isteği göndermemesi için diğer web sitelerindeki görseller varsayılan olarak engellenir. Görselleri görüntülemek için “Diğer web sitelerindeki görselleri yükle” seçeneğini açın. ./docs/screenshot.png gibi göreli yollar çalışmaz; çünkü dosyalar burada bulunmaz.
Dipnotlar, matematik ifadeleri veya diyagramlar destekleniyor mu?
Hayır. CommonMark ve GitHub Flavored Markdown'ı (tablolar, görev listeleri, üstü çizili metin, otomatik bağlantılar) destekler. Dipnotlar, LaTeX matematiği ve Mermaid diyagramları bu önizlemede düz metin olarak gösterilen uzantılardır.
Tek satır sonu neden yeni bir satır başlatmıyor?
Standart Markdown'da paragraf içindeki tek satır sonu boşluk olarak değerlendirilir. Satırın sonuna iki boşluk ekleyin, araya boş bir satır koyun veya “Tek satır sonlarını <br> olarak işle” seçeneğini açın.
Gizlilik
Markdown tarayıcınızda dönüştürülür; yüklenmez veya saklanmaz. Diğer web sitelerindeki görsellere izin vermediğiniz sürece önizleme internetten hiçbir şey yüklemez. İzin verirseniz görseller doğrudan kendi sunucularından istenir.