HTML'den Markdown'a

Nasıl çalışır?

Eski bir blog yazısını, bir wiki sayfasını ya da bir e-posta bültenini Markdown kullanan bir yere taşıyacaksınız: GitHub, Notion, Obsidian, bir statik site üreticisi. HTML'i sol panele yapıştırın; Markdown sağ panelde oluşur. Örneğin <h2>Adımlar</h2> satırı ## Adımlar olur, <strong>5 dakikada</strong> **5 dakikada** olur, iç içe liste girintisiyle, tablo da boru işaretli GFM tablosu olarak çıkar. Kod bloğunun sınıfında dil adı varsa (language-bash) çit satırına yazılır. script ve style blokları atılır; sayfanın görünümüyle ilgili olan her şey Markdown'da karşılıksız olduğu için düşer, metin kalır. Sonuç satırı kaç başlık, liste, tablo ve bağlantı bulduğunu, kaç bloğun atıldığını söyler.

Bu araç html to markdown, html to md converter aramalarıyla da biliniyor.

Markdown nedir?

Markdown, düz metinde biçimi noktalama işaretleriyle gösteren bir yazım kuralıdır: satır başındaki diyez başlık, çift yıldız kalın, tire madde demektir. Dosya işlenmeden de okunur; bu yüzden README dosyaları, not uygulamaları ve belge siteleri onu tercih eder. HTML'den Markdown'a geçerken amaç, içeriği bu okunur biçime indirmektir.

GFM tablosu nedir?

GFM (GitHub biçimli Markdown) tablosu, sütunları boru işaretiyle ayırır ve başlık satırının altına tirelerden oluşan bir ayırıcı satır koyar. Temel Markdown'da tablo yoktur; bu ek GitHub ile yaygınlaştı ve bugün çoğu Markdown işleyicisi tanır. Hücre birleştirme ve hücre içinde çok satır desteklemediği için karmaşık HTML tabloları bu biçime tam sığmaz.

HTML ile Markdown arasındaki fark nedir?

HTML, tarayıcıya sayfanın her ayrıntısını anlatır: yapı, görünüm, etkileşim. Markdown yalnız yapıyı taşır ve insanın okuması için tasarlanmıştır. HTML'den Markdown'a geçişte başlık, liste, tablo, bağlantı ve vurgu korunur; renk, yazı tipi ve düzen bilgisi kaybolur. Bu bir eksiklik değil amaçtır: Markdown'a çevrilen metin her ortamda aynı şekilde okunur ve kolayca düzenlenir.

Markdown'da karşılığı olmayanlar

Markdown, HTML'in küçük bir alt kümesini anlatır. Renk, yazı boyutu, hizalama ve sütun düzeni gibi görünüm bilgisi taşınmaz; bunlar atılır, içindeki metin kalır.

Birleşik hücreli tablolar (colspan, rowspan) GFM tablosunda yazılamaz. Araç böyle bir tabloyu düz tabloya indirir ve sonuç satırında "birleşik hücreli tablo düz tabloya indi" uyarısını gösterir; tabloyu çıktıda kontrol edin.

Markdown'da özel anlamı olan işaretler (yıldız, alt çizgi, köşeli parantez) düz metinde geçiyorsa önüne ters eğik çizgi eklenir. Böylece a_b gibi bir yazı italiğe dönüşmez.

Hangi seçeneği ne zaman seçmeli?

Başlıkta diyez yazımı hemen her yerde çalışır ve üç ile altıncı düzey başlıkların tek yazımıdır. Altı çizili yazım yalnız birinci ve ikinci düzey için vardır; eski README dosyaları ve bazı belge sistemleri bunu tercih eder. Bu seçenekte üçüncü düzey ve altı yine diyezle kalır.

Referans listesi, bağlantısı çok olan uzun metinlerde paragrafları okunur tutar: metinde yalnız [panel][1] yazar, adresler sona toplanır. Kısa metinlerde satır içi yazım daha pratiktir.

Sık sorulanlar

Web sayfasının tamamını yapıştırabilir miyim?

Evet. head bölümü, betikler ve stiller atılır, gövdedeki içerik çevrilir. Yine de menü, alt bilgi ve yan sütun da metin olarak çıktıya girer; yalnız makaleyi istiyorsanız sayfa kaynağından makale bölümünü seçip yapıştırın.

Görseller ne oluyor?

Her görsel  satırına çevrilir; görselin kendisi indirilmez, adresi yazılır. Sayfaya gömülü (data: ile başlayan) görseller çok uzun olduğu için çıktıya alınmaz.

Tersini, Markdown'dan HTML'e çeviriyi de yapabilir miyim?

Evet, bunun için Markdown'dan HTML'e çevirici aracını kullanın. İki araç birlikte çalışır: burada ürettiğiniz Markdown orada yeniden HTML'e çevrilebilir.

HTML kodum bir yere gönderiliyor mu?

Hayır. Çeviriyi yapan kütüphane tarayıcınızda çalışır; yapıştırdığınız kod bu sayfadan hiçbir sunucuya gitmez.