Markdown Dönüştürücü

Gerçek zamanlı önizleme oluşturma ile Markdown ve HTML arasında çift yönlü dönüştürmeyi destekler. GFM genişletilmiş sözdizimi, kod vurgulama, KaTeX matematik formülleri ve Mermaid diyagramlarını destekler, belge yazma, blog yayınlama ve e-posta zengin metin oluşturma için uygundur.

Kullanım talimatları

🚀 Hızlı başlangıç

İçeriği sol taraftaki giriş alanına yapıştırın.
Dönüştürme modunu seçin (→HTML veya →Markdown).
İçerik otomatik olarak dönüştürülür; sonuç sağ tarafta görünür.
Önizleme/HTML çıktısı: Markdown → HTML modunda KaTeX/Mermaid varsayılan olarak render edilir.

📌 Yaygın kullanım senaryoları

Blog/doküman önizlemesi: Markdown’un nasıl render edildiğini ve renkleri hızlıca kontrol edin.
E‑posta gönderimi: dışa aktarılan HTML’yi e‑posta gövdesine yapıştırın (tercihen satır içi stillerle).
Zengin metin → Markdown: web/CMS zengin metnini sürüm kontrollü Markdown’a dönüştürün.
Teknik dokümanlar: formülleri ve diyagramları tek adımda render edin ve dışa aktarın.
Editör geçişi: farklı Markdown varyantları arasındaki farkları uyumlu hâle getirin.
Wiki/bilgi tabanı: HTML sayfalarını içe aktarmak için Markdown’a dönüştürün.
API değişiklik günlüğü: HTML/açıklamaları gözden geçirme/PR için Markdown’a dönüştürün.

🎛️ Dönüştürme parametreleri ve render

Markdown → HTML modunda KaTeX/Mermaid otomatik olarak render edilir.
HTML → Markdown, kaynağı olabildiğince korur/geri kazandırır; yeniden render yapılmaz.
GFM (tablolar/görev listeleri) varsayılan olarak etkindir; daha katı davranış için standart Markdown sözdizimini kullanın.
Yumuşak satır sonları etkindir; daha katı davranış için boş satırlar veya satır sonunda iki boşluk kullanın.
Çok büyük girdiler, performansı korumak için kısıtlı önizlemeyi tetikleyebilir (sınırlı render/vurgulama yok).

🧭 Kullanım tavsiyeleri

E‑posta: uyumluluğu artırmak için satır içi stilleri tercih edin.
Uzun dokümanlar: gecikmeyi önlemek için içeriği parçalara ayırarak dönüştürün.

⚠️ Sınırlamalar ve uyumluluk

Varyant farkları: render davranışı platformlar arasında değişebilir; mümkün olduğunda ortak sözdizimi tercih edin.
HTML → Markdown, en iyi çabayla çalışır: birçok stil/düzen bilgisi kaybolabilir.
HTML → Markdown, HTML’in bazı bölümlerini yok sayar (script/style/meta, gömülü formlar, medya, on* olayları, style/class vb.).
Karmaşık tablolar ve iç içe yapılar bozulabilir; lütfen sonucu manuel olarak gözden geçirin.
Görseller/videolar dış bağlantı olarak kalır; indirilmez.
Üçüncü tarafça önceden render edilmiş Mermaid SVG’leri güvenilir şekilde geri çevrilemez.

🔒 Gizlilik ve güvenlik

Tüm işlemler tarayıcınızda gerçekleşir; veriler cihazınızı terk etmez.
Yapıştırılan HTML içindeki <script> çalıştırılmaz.
KaTeX/Mermaid güvenli yapılandırmalarla render edilir.
Tüm HTML içeriği otomatik olarak temizlenmez; lütfen canlıya almadan önce ve sonra çıktıyı gözden geçirin.

❓ Sıkça Sorulan Sorular

Önizleme hedef platformdan farklı görünüyor—nasıl teşhis ederim?

Hedef Markdown varyantını belirleyin (CommonMark/GFM/özel). Ham HTML ve özel uzantılardan kaçının. Standart satır sonları kullanın (boş satırlar veya satır sonunda iki boşluk). Önce minimal bir örneğe indirip hedef platformda test edin, sonra genişletin.

Dışa aktarılan HTML’yi canlı ortama güvenli şekilde nasıl taşıyabilirim?

Araç <script> çalıştırmaz ancak içeriği otomatik olarak temizlemez. Sunucu veya yayın hattında izinli liste yaklaşımı kullanan bir kütüphane (ör. DOMPurify) ile sanitizasyon yapın, on* olay işleyicilerini ve tehlikeli URI şemalarını engelleyin, dış/yerleşik betikler için CSP uygulayın.

HTML → Markdown karmaşık yapıları bozuyor—ne yapmalıyım?

Taşınabilir anlamsal yapıları tercih edin: iç içe tablolar/listeleri pipe tablolara ve daha düz listelere dönüştürün; dönüştürmeden önce span/style/class bilgilerini atmak için içeriği düz metin olarak yapıştırın; minimal bir vaka ayırıp kaynağı buna göre ayarlayın.

KaTeX/Mermaid sınırları ve sorun giderme?

Sözdizimi: KaTeX için $$…$$ veya satır içi $…$; Mermaid için ```mermaid ile çevrili bloklar. Büyük girdiler, kaynağı gösterme/vurgulamayı kapatma gibi kısıtlı önizlemeye düşebilir. Yoğunluğu azaltın, bölümler hâlinde dönüştürün ve sorunlu sözdizimini bulmak için minimal örnekler kullanın. Geri kazanım: KaTeX render edilmiş HTML’den geri kazanılabilir; Mermaid için geri kazanım yalnızca bu araç tarafından kaynağı gömülü diyagramlarda güvenilir çalışır.