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

HTML'i Markdown'a çevirmek ne işe yarar?

Bir web sayfasındaki yazıyı not uygulamanıza, bir wiki'ye, GitHub deposundaki README dosyasına ya da statik site oluşturucunuzun içerik klasörüne taşımak istediğinizde elinizde genellikle HTML bulunur. Etiketlerle dolu bu kaynağı düz metne çevirmek, yani başlıkları "##", listeleri "-", bağlantıları "[metin](adres)" biçimine dökmek elle yapıldığında saatler alabilir ve hataya açıktır. Bu araç HTML kaynağını okur, yapısını anlar ve temiz bir Markdown çıktısı üretir. İki bölmeli ekranda Markdown'ı ve kaynağın önizlemesini yan yana görürsünüz; doğruysa kopyalar ya da .md dosyası olarak indirirsiniz.

Dönüşümde, bu iş için en yaygın kullanılan açık kaynaklı kütüphane olan turndown ve GFM tabloları için onun eklentisi çalışır. İkisi de MIT lisanslıdır ve sitemizin içinde sabit sürümlerle durur. Sayfa internet gerektirmez; HTML'iniz hiçbir sunucuya gönderilmez ve kaynağın içindeki bağlantılar ya da görseller getirilmez. Yani sayfa kaynağındaki bir resim adresine hiçbir istek yapılmaz.

Nasıl kullanılır?

1. Dönüştürmek istediğiniz HTML'i kutuya yapıştırın ya da bir .html dosyasını kutuya bırakın. Tarayıcıda "Sayfa kaynağını görüntüle" ile aldığınız metni olduğu gibi kullanabilirsiniz.
2. Başlık stilini (#'li ya da altı çizgili), madde işaretini (-, * veya +) ve kod bloğu biçimini seçin. Bağlantıları ve görsel işaretlerini koruyup korumayacağınızı belirleyin.
3. Tam bir sayfa kaynağı yapıştırdıysanız "Yalnızca ana içerik" seçeneğini açın; menü, üst ve alt bilgi gibi bölümler atılır, yalnızca main ya da article içeriği çevrilir.
4. Sağdaki önizlemeyle soldaki Markdown'ı karşılaştırın. Beğendiyseniz "Markdown'ı kopyala" ile panoya alın ya da ".md olarak indir" ile kaydedin.

Seçenekler ne yapar?

Başlık stili. ATX biçimi her başlığı "#" işaretleriyle yazar: ## Giriş. Setext biçimi ise yalnızca birinci ve ikinci seviye başlıklar için başlığın altına eşittir ya da tire dizisi koyar. Çoğu araç ve platform ATX'i tercih eder; varsayılan da odur.

Madde işareti. Sırasız listeler tire, yıldız ya da artı ile yazılabilir. Hepsi geçerli Markdown'dır; ekibinizin stil kılavuzu hangisini istiyorsa onu seçin. Araç, madde işaretinden sonra tek boşluk bırakır (- madde) ve iç içe listelerde alt maddeleri doğru hizayla girintiler. Sıralı listeler 1., 2., 3. diye numaralanır; HTML'deki start özniteliğine saygı gösterilir.

Kod bloğu. Çit biçimi bloğu üç ters tırnakla (ya da tilde ile) çevreler; dil adı HTML'de language-js gibi bir sınıf olarak varsa çitin yanına yazılır. Girintili biçim her satırı dört boşlukla başlatır; eski Markdown işlemcileriyle uyumluluk gerektiğinde işe yarar.

Bağlantılar ve görseller. Bağlantılar kapatıldığında yalnızca tıklanabilir metin kalır; yazıyı alıp adresleri çıkarmak istediğinizde kullanışlıdır. Görsel işaretleri açıkken ![alt metin](adres) yazılır, ancak görsel dosyası indirilmez ve adresine istek yapılmaz.

Tablolar nasıl dönüşür?

GFM tablo seçeneği açıkken başlık hücreleri (th) içeren HTML tabloları, dik çizgilerle ayrılmış Markdown tablosuna dönüşür. Başlık satırının altına | --- | --- | ayırıcısı eklenir; hücre içindeki dik çizgiler kaçışlanır. Yönlendirme için kullanılan align özniteliği ayırıcıdaki iki nokta işaretlerine (:---, :---:) yansır. Üstü çizili metin (del, s) çift tildeyle, görev listesi onay kutuları [ ] ve [x] ile yazılır.

Markdown tablolarının bir sınırı vardır: hücrelerin içinde birden çok paragraf, iç içe tablo ya da birleştirilmiş hücre (colspan, rowspan) olamaz. HTML kaynağınızda bunlar varsa araç tabloyu olabildiğince düz hâle getirir, ama birleşik hücrelerde sonucu elle düzeltmeniz gerekebilir. Başlık satırı (th) olmayan tablolarda ilk satır başlık gibi ele alınır.

Neleri atar, neleri korur?

Dönüştürmeden önce kaynak, tarayıcının etkisiz bir belgesinde ayrıştırılır; script, style, noscript, iframe, svg, link ve meta etiketleri atılır. Bunlar zaten Markdown'da karşılığı olmayan, çoğunlukla sayfa mekaniğine ait parçalardır. Yazının kendisi, yani başlıklar, paragraflar, listeler, alıntılar, kod, vurgular, bağlantılar, görseller, tablolar ve yatay çizgiler korunur. Satır içi renk ve boyut gibi biçimlendirme Markdown'da ifade edilemediği için kaybolur; bu bir hata değil, biçimin doğasıdır.

Kaynağın önizlemesi, betik çalıştırmayan ve hiçbir dış kaynağı yüklemeyen yalıtılmış bir çerçevede gösterilir. Bu yüzden başkasından aldığınız bir sayfa kaynağını da güvenle yapıştırabilirsiniz; çalıştırılabilir hiçbir şey çalışmaz.

Hangi durumlarda işinize yarar?

• Eski bir blog ya da CMS içeriğini Hugo, Jekyll, Astro gibi Markdown tabanlı bir sisteme taşırken.
• Bir e-posta ya da duyuru metnini wiki, Notion, Obsidian gibi bir not uygulamasına aktarırken.
• Bir web sayfasından alınan dokümantasyonu depodaki README ile birleştirirken.
• HTML ile yazılmış bir yardım sayfasını sadeleştirip sürüm kontrolüne uygun düz metne çevirirken.
• Bir sayfanın yazı içeriğini yapay zekâ araçlarına ya da özetleme akışlarına daha az gürültüyle vermek isterken.

Telifli ya da size ait olmayan içeriği çevirirken kaynağın kullanım koşullarına dikkat edin. Araç yalnızca sizin verdiğiniz metni dönüştürür; herhangi bir adresten içerik çekmez.

Neden Bilişim Ajans aracı?

• HTML'iniz bilgisayarınızdan çıkmaz. Dönüşüm tarayıcıda yapılır; dış kaynak çekilmez, sayfa çevrimdışı da çalışır.
• Temiz Markdown. Tek boşluklu liste işaretleri, doğru girintili alt listeler, GFM tabloları.
• Yan yana önizleme. Çıktıyı kaydetmeden önce kaynakla karşılaştırırsınız.
• Gerçek seçenekler. Başlık stili, madde işareti, kod çiti, bağlantı ve görsel tercihleri.
• Gerçekten ücretsiz. Kayıt, filigran, günlük sınır ve sahte "premium" yok.

Sık sorulan sorular

İlgili araçlar

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

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.