Convertitore da HTML a Markdown

Cos'è la Conversione da HTML a Markdown?

La conversione da HTML a Markdown trasforma il markup HTML in Markdown, una sintassi di formattazione in testo semplice creata da John Gruber nel 2004. Markdown è stato progettato per essere leggibile senza rendering. Dove HTML richiede tag di apertura e chiusura come <strong> e <a href="">, Markdown usa caratteri abbreviati: **grassetto**, [link](url) e # intestazioni. Convertire HTML in Markdown produce file più facili da leggere, modificare e gestire con il controllo versione rispetto all'HTML grezzo.

Il processo di conversione mappa gli elementi HTML nei loro equivalenti Markdown. Un <h2> diventa ##, un <ul><li> diventa - elemento, e un tag <a> diventa [testo](url). Alcuni elementi HTML non hanno un equivalente diretto in Markdown, come <div>, <span> o attributi dati personalizzati. I convertitori di solito rimuovono questi tag o li passano come HTML grezzo, a seconda della configurazione.

Markdown è diventato il formato di scrittura standard per la documentazione degli sviluppatori (GitHub, GitLab, Bitbucket), i generatori di siti statici (Hugo, Jekyll, Astro), le app per prendere appunti (Obsidian, Notion) e i blog tecnici. Convertire contenuti HTML esistenti in Markdown è un passaggio comune quando si migrano siti web, si importano contenuti da un CMS o si archiviano pagine web in un formato portatile. A differenza dell'HTML, i file Markdown producono diff puliti nel controllo versione, rendendo pratica la revisione delle modifiche alla documentazione.

Perché Usare un Convertitore da HTML a Markdown?

Riscrivere manualmente l'HTML in Markdown è lento e soggetto a errori, specialmente per pagine con elenchi annidati, tabelle o decine di link. Un convertitore automatico gestisce la mappatura strutturale all'istante e in modo coerente.

Casi d'Uso da HTML a Markdown

Riferimento agli Elementi da HTML a Markdown

La tabella seguente mostra come gli elementi HTML comuni vengono mappati nei loro equivalenti Markdown. Questa mappatura segue le convenzioni di GitHub Flavored Markdown (GFM), che estende la specifica CommonMark con tabelle, testo barrato ed elenchi di attività. Gli elementi non elencati qui (come <div>, <form> o componenti web personalizzati) non hanno un equivalente Markdown e vengono rimossi o passati come HTML grezzo.

Varianti Markdown: GFM vs CommonMark vs Originale

Non tutti i Markdown sono uguali. Il formato di output è importante perché le diverse piattaforme analizzano il Markdown in modo diverso. Le tre varianti più comuni sono GitHub Flavored Markdown (GFM), CommonMark e il Markdown originale di Gruber.

Esempi di Codice

Esempi funzionanti in JavaScript (Turndown), Python (markdownify e html2text), Go e Pandoc da riga di comando.

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

Domande Frequenti