HTML'den Markdown'a Dönüştürücü

HTML'den Markdown'a Dönüşüm Nedir?

HTML'den Markdown'a dönüşüm, HTML biçimlendirmesini John Gruber tarafından 2004 yılında oluşturulan hafif, düz metin biçimlendirme sözdizimi olan Markdown'a dönüştürür. Markdown, render edilmeden de okunabilir olacak şekilde tasarlanmıştır. HTML'nin <strong> ve <a href=""> gibi açılış-kapanış etiketleri gerektirdiği yerde Markdown kısa karakterler kullanır: **kalın**, [bağlantılar](url) ve # başlıklar. HTML'yi Markdown'a dönüştürmek, ham HTML'ye kıyasla okunması, düzenlenmesi ve sürüm kontrolüyle yönetilmesi daha kolay dosyalar üretir.

Dönüşüm süreci HTML öğelerini Markdown karşılıklarıyla eşleştirir. Bir <h2> ## olur, <ul><li> ise - öğe olur ve bir <a> etiketi [metin](url) biçimini alır. <div>, <span> veya özel veri öznitelikleri gibi bazı HTML öğelerinin doğrudan Markdown karşılığı yoktur. Dönüştürücüler, yapılandırmaya bağlı olarak bu etiketleri genellikle ya siler ya da ham HTML olarak geçirir.

Markdown, geliştirici belgeleri (GitHub, GitLab, Bitbucket), statik site oluşturucuları (Hugo, Jekyll, Astro), not alma uygulamaları (Obsidian, Notion) ve teknik bloglar için standart yazma biçimi haline gelmiştir. Mevcut HTML içeriğini Markdown'a dönüştürmek; web sitesi taşırken, CMS içeriği aktarırken veya web sayfalarını taşınabilir bir biçimde arşivlerken yaygın bir adımdır. HTML'nin aksine Markdown dosyaları, sürüm kontrolünde temiz farklar üretir ve bu da belgeleme değişikliklerinin kod incelemesini pratik hale getirir.

Neden HTML'den Markdown'a Dönüştürücü Kullanmalısınız?

HTML'yi Markdown olarak elle yeniden yazmak, özellikle iç içe listeler, tablolar veya onlarca bağlantı içeren sayfalarda yavaş ve hataya açık bir işlemdir. Otomatik bir dönüştürücü, yapısal eşleştirmeyi anında ve tutarlı biçimde gerçekleştirir.

HTML'den Markdown'a Kullanım Senaryoları

HTML'den Markdown'a Öğe Başvurusu

Aşağıdaki tablo, yaygın HTML öğelerinin Markdown karşılıklarıyla nasıl eşleştirildiğini göstermektedir. Bu eşleştirme, tablolar, üstü çizili metin ve görev listeleriyle CommonMark belirtimini genişleten GitHub-Flavored Markdown (GFM) kurallarını izler. Burada listelenmeyen öğeler (<div>, <form> veya özel web bileşenleri gibi) Markdown karşılığı olmadığından ya silinir ya da ham HTML olarak geçirilir.

Markdown Çeşitleri: GFM, CommonMark ve Orijinal

Tüm Markdown'lar aynı değildir. Farklı platformlar Markdown'ı farklı şekilde işlediğinden çıktı biçimi önemlidir. En yaygın üç çeşit şunlardır: GitHub-Flavored Markdown (GFM), CommonMark ve Gruber'in orijinal Markdown'ı.

Kod Örnekleri

JavaScript (Turndown), Python (markdownify ve html2text), Go ve komut satırında Pandoc ile çalışan örnekler.

import TurndownService from 'turndown'

const turndown = new TurndownService({ headingStyle: 'atx' })
const html = '<h1>Title</h1><p>A <strong>bold</strong> paragraph.</p>'
const md = turndown.turndown(html)
console.log(md)
// → "# Title\n\nA **bold** paragraph."

from markdownify import markdownify

html = '<h2>Section</h2><ul><li>First</li><li>Second</li></ul>'
md = markdownify(html, heading_style='ATX')
print(md)
# → "## Section\n\n- First\n- Second"

import html2text

converter = html2text.HTML2Text()
converter.body_width = 0  # disable line wrapping

html = '<p>Visit <a href="https://example.com">Example</a> for details.</p>'
md = converter.handle(html)
print(md)
# → "Visit [Example](https://example.com) for details."

package main

import (
	"fmt"
	md "github.com/JohannesKaufmann/html-to-markdown"
)

func main() {
	converter := md.NewConverter("", true, nil)
	html := `<h3>Go Example</h3><p>Code: <code>fmt.Println()</code></p>`
	markdown, _ := converter.ConvertString(html)
	fmt.Println(markdown)
	// → "### Go Example\n\nCode: `fmt.Println()`"
}

# Convert an HTML file to Markdown
pandoc input.html -f html -t markdown -o output.md

# Pipe HTML from stdin
echo '<p>Hello <em>world</em></p>' | pandoc -f html -t markdown
# → Hello *world*

# Use GitHub-Flavored Markdown output
pandoc input.html -f html -t gfm -o output.md

Sıkça Sorulan Sorular