Markdown HTML'e nasıl dönüştürülür?

Markdown metnini sol alana yapıştırın ve Dönüştür düğmesine basın. Dönüşüm her tuş vuruşunda çalışmaz; böylece büyük metinlerde ağır bir işlem yazmanızı yavaşlatmaz. Sonuçta iki alan görünür: üstte güvenli önizleme, altta kopyalanabilir HTML kaynağı. Satır sonlarının <br> olarak korunmasını istiyorsanız ilgili kutuyu işaretleyin; kapalıyken tek satır sonları boşluk gibi davranır.

Kopyala düğmesi HTML parçasını panoya alır, İndir düğmesi aynı parçayı küçük bir HTML5 belgesine sarar. İki çıktı da yalnızca temizleme ve denetimden geçmiş HTML'dir; ham dönüşüm sonucu hiçbir zaman dışarı verilmez.

Desteklenen Markdown altkümesi

Araç CommonMark tarzı bir altküme kullanır ve GitHub'a özgü eklentileri kapalı tutar. Aşağıdaki yapılar HTML'e çevrilir.

MarkdownHTML çıktısı
Bir ile altı arası diyez ile başlıkh1 - h6
Boş satırla ayrılmış metinp
Yıldız veya alt çizgi ile vurguem
Çift yıldız ile kalın metinstrong
Tire veya sayıyla listeul, ol, li
Büyüktür işaretiyle alıntıblockquote
Ters tırnakla kod ve çitli kod bloğucode, pre
Köşeli ve yuvarlak parantezle bağlantıa (yalnızca güvenli adres)
Üç tire ve satır sonuhr, br

Tablo, üstü çizili metin, görev listesi, dipnot, çıplak URL algılama ve eklentiler bu sürümde yoktur. Desteklenmeyen sözdizimi hata vermez; metin olarak kalır.

Ham HTML ve resimler neden dönüştürülmez?

Markdown içine yazılan <script> veya <iframe> gibi etiketler çalıştırılmaz ve HTML olarak da çıktıya geçmez; görünür metin olarak kaçışlanır. Resim söz dizimi !açıklama de bir img etiketine dönüşmez, yazdığınız gibi metin kalır. Bunun iki nedeni vardır. Dışarıdan yüklenen bir resim veya gömülü içerik, sayfayı açan kişinin tarayıcısını bir adrese bağlar. Güvenli olmayan HTML ise temizleme katmanını sınamak yerine baştan engellenir. Resim eklemek istiyorsanız dönüşümden sonra kendi sitenizin şablonunda ekleyin.

Güvenli önizleme ve temizleme

Çıktı iki katmandan geçer. Birinci katman Markdown ayrıştırıcısıdır: ham HTML metne çevrilir, resimler metin kalır, bağlantılar yalnızca http, https veya / ile başlayan kök-göreli yol olabilir ve kod bloklarında sınıf özniteliği üretilmez. İkinci katman tarayıcıda çalışan DOMPurify temizleyicisidir; yalnızca yukarıdaki etiketlere ve a üzerindeki href özniteliğine izin verir. Bağlantı denetimi, tarayıcının HTML varlıklarını çözmesinden sonra yapılır; javascript:, data:, blob:, file: ve // ile başlayan protokolsüz adresler bağlantıyı düz metne çevirir.

Temizleme sonucu ayrıca bağımsız bir denetimden geçer: HTML yeniden ayrıştırılır, her etiket ve öznitelik izin listesiyle karşılaştırılır ve yeniden serileştirmenin aynı metni verdiği doğrulanır. Denetim başarısız olursa kopyalama ve indirme kapalı kalır. Önizleme, sandbox özniteliği boş olan bir iframe içinde gösterilir: betik, form, açılır pencere ve aynı kaynak izni yoktur. İçerik güvenlik ilkesi resim, stil, yazı tipi, bağlantı ve çerçeve yüklemeyi engeller. Önizlemedeki bağlantılar tıklanamaz; adresleri parantez içinde düz metin olarak görünür.

Örnek dönüşüm

Aşağıdaki Markdown, bu araçtaki dönüştürücüyle ikinci kutudaki HTML'i verir. Başlık düzeyi, kalın metin, liste ve bağlantı korunur; bağlantının adresi normalleştirilmiş biçimiyle yazılır. Aynı girdiyi Örnek yükle düğmesiyle kendiniz deneyebilirsiniz.

# Merhaba Markdown

Metin **kalın** ve [bağlantı](https://example.com/rehber).

- Birinci madde
- İkinci madde
<h1>Merhaba Markdown</h1>
<p>Metin <strong>kalın</strong> ve <a href="https://example.com/rehber">bağlantı</a>.</p>
<ul>
<li>Birinci madde</li>
<li>İkinci madde</li>
</ul>

İndirme, sınırlar ve sık hatalar

  • İndirilen HTML dosyasını tarayıcıda açıp bir bağlantıya tıkladığınızda tarayıcı o adrese ağ isteği yapabilir; bu araçtaki yerel çalışma sözü yalnızca dönüşüm ve önizleme için geçerlidir.
  • Girdi en fazla 100 KiB (102.400 bayt) UTF-8 olabilir; çıktı 1 MiB ile sınırlıdır. Bunlar bu aracın tasarım sınırlarıdır.
  • Çok derin iç içe alıntı ve liste yapıları reddedilir; üst sınır 20 düzeydir.
  • Ayrıştırma ayrı bir işçi iş parçacığında ve 3 saniyelik süre bütçesiyle çalışır; aşılırsa işlem durdurulur ve açık bir hata gösterilir.
  • Ayrıştırıcı veya temizleyici yerel dosyadan yüklenemezse araç hata verir; indirme kapalı kalır ve yedek bir ayrıştırıcıya geçilmez.

Kaynaklar ve doğrulama

Ayrıştırma MIT lisanslı marked 18.1.1 ile, temizleme Apache-2.0 seçeneğiyle kullanılan DOMPurify 3.4.17 ile yapılır. Sürümler, lisanslar ve güvenlik durumu 25 Ekim 2026 tarihinde incelenmiş ve sitede yerel dosya olarak tutulmaktadır; harici bir sunucudan betik yüklenmez. Önizleme sırasında sıfır harici istek yapıldığı ve betiğin çalışmadığı, kötü amaçlı örnek metinlerle gerçek bir tarayıcıda sınanmıştır.

Sık sorulan sorular

Markdown içindeki ham HTML neden çalışmıyor?

Ham HTML, çıktıyı açan kişinin tarayıcısında betik çalıştırabilir veya dışarıdan içerik yükleyebilir. Bu yüzden araç etiketleri metin olarak kaçışlar. Başlık, liste, vurgu, alıntı, kod ve güvenli bağlantı için Markdown söz dizimini kullanın.

Resim veya tablo ekleyebilir miyim?

Bu sürümde hayır. Resim söz dizimi ve tablolar HTML'e çevrilmez, metin olarak kalır. Resim yüklemek sayfayı açan kişinin tarayıcısını bir adrese bağlayacağı için bilerek kapalıdır.

Yazdığım metin sunucuya gidiyor mu?

Hayır. Ayrıştırma ve temizleme tarayıcınızda çalışır. Paylaşım bağlantısı yalnızca satır sonu ayarını taşır; metin bağlantıya, depolamaya veya ağ isteğine girmez.

İndirdiğim HTML'deki bağlantılar güvenli mi?

Yalnızca http, https ve kök-göreli adresler kalır; diğer her şey düz metne çevrilir. Dosyayı tarayıcıda açıp bir bağlantıya tıklamak yine de o adrese ağ isteği yapar. Bu, her HTML bağlantısında olduğu gibi normal tarayıcı davranışıdır.

Dönüşüm neden her tuşta çalışmıyor?

Markdown ayrıştırma büyük veya karmaşık metinlerde zaman alabilir. Dönüştür düğmesi, işlemi ayrı bir iş parçacığında ve süre bütçesiyle başlatır; böylece sayfa yanıt vermeye devam eder.

Yayın: · Güncelleme: