Markdown Ayrıştırıcı

GFM (GitHub Flavored Markdown), GitHub tarafından kullanılan bir Markdown lehçesidir. Standart Markdown'ı tablolar, görev listeleri, üstü çizili metin ve otomatik bağlantılar gibi özelliklerle genişletir.

Ayrıştırıcı çitli kod bloklarını render eder. Renkli tam sözdizimi vurgulama için, kod öğelerini stillendiren bir CSS stil sayfasıyla birlikte kullanabilirsiniz.

Evet! Markdown'ınızı editörde yazın, render edilen HTML'yi kopyalayın ve dokümantasyonunuzda, blogunuzda veya web sitenizde kullanın.

Orijinal Markdown (2004) birçok uç durumu tanımsız bıraktığı için uygulamalar farklılaştı. CommonMark bunları çözen titiz belirtimdir; GFM (GitHub Flavored Markdown) ise CommonMark artı uzantılardır: tablolar, görev listeleri, üstü çizili metin, otomatik bağlantılar ve bir disallowed-raw-HTML filtresi. Bu araç GFM'yi render eder ve GitHub'da gördüğünüzle eşleşir.

Satır içi kodu tek backtick içine alın. Çitli bloklar, sözdizimi vurgulama için açılış satırında ```python gibi bir dil etiketiyle üçlü backtick kullanır - ya da her satırı dört boşlukla girintileyin (listeler içinde kötü etkileşen eski sözdizimi). Kodunuzun kendisi backtick içeriyorsa üçlü tilde de çit olarak çalışır.

Evet - satır içi HTML etiketleri çıktıya geçer. GFM'nin disallowed-raw-HTML uzantısı, filtre etkinleştirildiğinde yalnızca birkaç tehlikeli etiketi (script, style, iframe ve benzerleri) kaldırır. İki uyarı: blok düzeyinde HTML, içinde Markdown sözdiziminin işlenmeyi durdurduğu içeriği sarar (boş satırlar önemlidir) ve kullanıcı tarafından gönderilen her Markdown, etiket filtresinin ötesinde XSS'e karşı temizlenmelidir.

Başlığın altında tirelerden ayırıcı satır bulunan, pipe ile ayrılmış satırlar. İki nokta hizalamayı belirler: solda iki nokta-tire sol hizalama (varsayılan), iki uçta iki nokta ortalar, tire-iki nokta sağ hizalar. Hücreler blok öğeleri içeremez; değişmez pipe'ı \| olarak kaçışın; ve her satırdaki dış pipe'lar isteğe bağlıdır. Daha karmaşık düzenler ham HTML veya bir dokümantasyon motoru gerektirir.

Olağan şüpheliler: tutarsız girinti (iç içe öğeler genellikle üst öğenin içeriğinin ilk karakteriyle hizalanmalı), paragraf ile liste arasında eksik boş satır veya sekme ile boşluğun karışması. CommonMark tüm bunlar için kesin kurallar belirtir. Sekmeleri boşluklara dönüştürmek ve listelerin çevresine boş satırlar eklemek, iç içe geçme hatalarının büyük çoğunluğunu düzeltir.