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

Markdown'dan HTML'e dönüştürme neden gerekir?

Markdown, düz metin yazarken başlık, liste, bağlantı ve tablo gibi biçimleri birkaç işaretle belirtmenizi sağlayan hafif bir yazım dilidir. README dosyaları, teknik dokümantasyon, blog taslakları ve not defterleri çoğunlukla bu biçimde tutulur. Ancak bir web sayfasına, e-posta şablonuna, içerik yönetim sistemine ya da bir sunum aracına koyduğunuz anda tarayıcının anladığı biçime, yani HTML'e ihtiyaç duyarsınız. Elinizde "# Başlık" gibi satırlar varken tarayıcı bunu düz yazı olarak gösterir; <h1> etiketine çevrildiğinde ise gerçek bir başlık olur. Bu araç, bu dönüşümü bir program kurmadan, bir komut satırı açmadan ve hesap oluşturmadan tarayıcınızın içinde yapar.

Dönüşüm, açık kaynaklı ve yaygın olarak kullanılan marked kütüphanesiyle yapılır. Kütüphane sitemizin içinde, sabit bir sürümde durur; dolayısıyla sayfa yüklendikten sonra internetinizi kapatsanız da çalışır. Yazdığınız metin hiçbir sunucuya gönderilmez, çünkü gönderilecek bir sunucu kodu yoktur. Şirket içi dokümanlar, henüz yayınlanmamış blog yazıları ya da müşteri bilgisi içeren notlar bu yüzden rahatça dönüştürülebilir.

Nasıl kullanılır?

1. Markdown metninizi kutuya yapıştırın ya da yazın. Dilerseniz bir veya birkaç .md dosyasını sürükleyip bırakın; ilk dosyanın içeriği kutuya yüklenir.
2. Çıktı biçimini seçin. "Tam belge" doctype, başlık ve gömülü stil içeren, tek başına açılabilen bir .html dosyası üretir. "Yalnızca gövde" ise bir sayfanın içine yapıştıracağınız etiketleri verir.
3. İsterseniz başlık id'lerini, tablo desteğini, kod bloğu stilini ve güvenli çıktıyı açıp kapatın. Sonuç her değişiklikte anında güncellenir.
4. "HTML kodu" sekmesinden kodu inceleyin, "HTML kodunu kopyala" ile panoya alın ya da ".html olarak indir" ile dosyayı kaydedin. "Önizleme" sekmesi sayfanın nasıl görüneceğini gösterir.
5. Birden çok dosyanız varsa hepsini birlikte seçin; "Tüm dosyaları ZIP olarak indir" her .md dosyasını aynı ayarlarla .html'e çevirip tek arşivde verir.

Tam belge ile yalnızca gövde arasındaki fark

"Tam belge" seçeneği, çıktıyı <!doctype html>, <html lang="tr">, <head> ve <body> ile sarar. Belge başlığı (title), Markdown içindeki ilk "#" başlığından alınır; yoksa dosya adı kullanılır. Okunabilir bir yazı tipi, makul bir satır genişliği, tablo kenarlıkları ve alıntı çizgisi gibi küçük bir stil de <style> içine gömülür. Böylece indirdiğiniz dosyayı çift tıklayıp tarayıcıda açtığınızda düzgün görünür, kimseye ek bir CSS dosyası göndermeniz gerekmez. Bu, bir dokümanı e-postayla paylaşmak ya da bir müşteriye göndermek için en pratik yoldur.

"Yalnızca gövde" ise sadece içerik etiketlerini verir: başlıklar, paragraflar, listeler, tablolar. Bunu bir blog yazısı editörüne, bir CMS'in "HTML" sekmesine ya da kendi şablonunuzun içine yapıştırırsınız; sitenizin kendi stilleri devreye girer. Mevcut bir sayfanın tasarımına uymasını istediğiniz her durumda bu seçeneği tercih edin.

Başlık id'leri ve içindekiler

Başlık id'leri açıkken her <h1>–<h6> etiketi, başlık metninden üretilen bir kimlik alır. Türkçe karakterler düzleştirilir: "Başlık" için baslik, "Kurulum ve Yapılandırma" için kurulum-ve-yapilandirma. Aynı başlıktan birden fazla varsa ikincisi baslik-1 gibi numaralanır, böylece kimlikler çakışmaz. Bu kimlikler sayesinde [Kuruluma git](#kurulum) gibi sayfa içi bağlantılar çalışır ve bir başlığa doğrudan bağlantı verebilirsiniz.

Kod blokları için satır içi stil

E-posta istemcileri, bazı kurumsal CMS'ler ve duyuru sistemleri harici CSS dosyalarını ya da <style> bloklarını kırpar. Böyle ortamlarda kod bloğunun gri arka planı ve tek aralıklı yazı tipi kaybolur. "Kod bloklarına satır içi stil ver" seçeneği, <pre> ve <code> etiketlerine doğrudan style özniteliği yazar; gri zemin, iç boşluk ve eşit aralıklı yazı tipi her yerde korunur. Bu seçenek kapalıyken stil, tam belge çıktısındaki <style> bloğunda yer alır.

Güvenli çıktı: script ve iframe nasıl ayıklanır?

Markdown, satır içinde ham HTML'e izin verir. Yani bir .md dosyasının içinde <script> ya da <iframe> etiketi varsa dönüştürücü bunu olduğu gibi çıktıya taşıyabilir. Başkasından aldığınız bir dosyayı dönüştürüp sitenizde yayınlarsanız, bu etiketler ziyaretçilerinizin tarayıcısında çalışabilir. "Güvenli çıktı" seçeneği (varsayılan olarak açıktır) bunu önler: çıktı önce tarayıcının etkisiz bir belgesinde ayrıştırılır; script, iframe, object, embed, form, style, svg gibi etiketler içerikleriyle birlikte silinir; onclick gibi olay öznitelikleri ve javascript: ile başlayan bağlantılar kaldırılır. Bağlantılara rel="noopener noreferrer" eklenir. Yalnızca kendi yazdığınız ve ham HTML içermediğinden emin olduğunuz metinler için bu seçeneği kapatabilirsiniz; önizleme sekmesi her durumda betik çalıştırmayan, ağ erişimi olmayan yalıtılmış bir çerçevede gösterilir.

Bu temizleme, kapsamlı bir güvenlik denetiminin yerini tutmaz. Üçüncü kişilerden gelen içeriği yayınlıyorsanız yayın sisteminizin kendi süzgeçlerini de kullanmanız doğru olur.

Toplu dönüştürme ve ZIP

Bir klasör dolusu not, dokümantasyon sayfası ya da blog taslağınız varsa her birini tek tek yapıştırmanız gerekmez. Dosyaları birlikte seçin; araç hepsini okur, mevcut seçeneklerle sırayla dönüştürür ve her biri kendi adıyla (kurulum.md için kurulum.html) bir ZIP arşivine koyar. İlerleme çubuğu kaçıncı dosyada olduğunuzu gösterir. Aynı adı taşıyan iki dosya olursa ikincisine numara eklenir, böylece hiçbiri ezilmez. Arşiv, tarayıcınızda oluşturulur ve doğrudan indirilir.

Hangi Markdown özellikleri desteklenir?

• Başlıklar (#, ##, ###…), kalın, eğik ve üstü çizili metin.
• Sıralı ve sırasız listeler, iç içe listeler, görev listeleri.
• Bağlantılar, görseller, alıntı blokları ve yatay çizgiler.
• Üç ters tırnaklı kod blokları ve satır içi kod.
• GFM tabloları (hizalama işaretleriyle birlikte).

Dil adı belirtilen kod bloklarında (örneğin ```js) <code class="language-js"> sınıfı korunur; renklendirme için kendi sayfanızda bir sözdizimi renklendirici kullanabilirsiniz. Araç renklendirme yapmaz, çünkü bunun için ayrı bir betik gerekir.

Neden Bilişim Ajans aracı?

• Metniniz bilgisayarınızdan çıkmaz. Dönüşüm tarayıcıda yapılır; sayfa çevrimdışı da çalışır.
• Gerçek çıktı seçenekleri. Tam belge ya da yalnızca gövde, id'ler, GFM, satır içi stil ve güvenli çıktı tek ekranda.
• Toplu çalışma. Birçok .md dosyasını bir ZIP'te .html olarak alırsınız.
• Önizleme. Kodu kopyalamadan önce sonucu görürsünüz.
• Gerçekten ücretsiz. Kayıt, filigran, günlük sınır ve sahte "premium" yok.

Sık sorulan sorular

İlgili araçlar

• Markdown Editör ve Önizleme
• HTML → Markdown Dönüştürücü
• Metin Araçları
• JSON Biçimlendir

Dokümantasyon sitenizi, bilgi tabanınızı ya da içerik akışınızı otomatikleştirmek istiyorsanız Bilişim Ajans ekibi yardımcı olur.