HTML to Markdown

Il convertitore gestisce intestazioni (h1–h6), paragrafi, grassetto, corsivo, testo barrato, codice inline, blocchi di codice con delimitatori, blockquote, linee orizzontali, link, immagini, liste ordinate, liste non ordinate, liste annidate e tabelle — coprendo l'intero set di funzionalità CommonMark e GitHub Flavored Markdown (GFM). Gli elementi strutturali sconosciuti come div, section e article passano attraverso i propri figli in modo trasparente, quindi nessun contenuto viene mai perso. La maggior parte degli HTML del mondo reale — da un'esportazione CMS, un articolo estratto dal web o una pagina di documentazione — si converte senza alcuna post-elaborazione da parte tua.

Pandoc è un potente convertitore da riga di comando, ma richiede installazione, un terminale e la conoscenza dei suoi flag. È lo strumento giusto per pipeline automatizzate lato server, ma eccessivo per una conversione occasionale. Turndown.js è la libreria JavaScript più usata per il lavoro HTML-to-Markdown — oltre 2,5 milioni di download settimanali su npm, più di 10.800 stelle su GitHub — e questo strumento usa lo stesso approccio di analisi basato sul DOM che rende Turndown affidabile. La differenza è che tutto gira nel tuo browser: nessuna installazione, nessuna riga di comando, nessun round-trip al server e nessun file lascia il tuo dispositivo. Turndown richiede la configurazione di un progetto Node; questo no.

Markdown è il formato di testo normale standard per la scrittura tecnica, la documentazione e la gestione dei contenuti. Convertire HTML in Markdown ti permette di importare contenuti in Notion o Obsidian, di effettuare il commit in un repository Git insieme al codice, di pubblicarlo tramite generatori di siti statici come Astro, Hugo o Jekyll, o di inserirlo in modelli AI e LLM. La ricerca pubblicata nel 2024 mostra che Markdown riduce l'uso di token del 68–87% rispetto all'HTML grezzo quando utilizzato con modelli linguistici di grandi dimensioni — una reale differenza di costi e accuratezza nella creazione di pipeline RAG o nella preparazione di dataset di fine-tuning.

Sì — la migrazione CMS è uno dei casi d'uso professionali più comuni. Incolla HTML esportato da WordPress, Confluence, SharePoint, Ghost o qualsiasi altra piattaforma e ottieni Markdown pulito da importare in un nuovo sistema. L'esportazione di WordPress ti fornisce blocchi di contenuto HTML; Confluence esporta le pagine come HTML o XHTML — entrambi si convertono senza problemi. Per risultati migliori, incolla solo il corpo del contenuto piuttosto che l'HTML completo della pagina, inclusi navigazione e footer. I team hanno usato la conversione HTML-in-Markdown basata su browser per migrare siti di documentazione di 150–200 pagine in meno di due giorni, senza toccare la riga di comando.

Le tabelle vengono convertite nel formato pipe-table di GitHub Flavored Markdown (GFM), con una riga separatore di trattini dopo la riga di intestazione. Quel formato funziona su GitHub, GitLab, anteprima di VS Code, Notion, Obsidian, Docusaurus e praticamente tutti i moderni renderer Markdown. Le tabelle annidate vengono appiattite perché il Markdown standard non le supporta nativamente. L'allineamento delle colonne — sinistro, centrato, destro tramite l'attributo align o il CSS text-align — viene preservato usando il posizionamento dei due punti nella riga separatore (es. :--- per sinistra, :---: per centro, ---: per destra).

Sì. La conversione avviene interamente nel tuo browser usando il parser DOM integrato — nessun file viene caricato e nessuna connessione internet è necessaria dopo il caricamento della pagina. Questo lo rende sicuro da usare con HTML riservato come documentazione interna, riferimenti API proprietari o lavoro per clienti che non dovrebbe lasciare il tuo dispositivo. Puoi verificarlo: apri gli Strumenti per sviluppatori del browser, vai alla scheda Rete e conferma che non viene inviata alcuna richiesta di rete quando incolli HTML e avvii una conversione. Niente lascia il tuo computer.

Rimuove gli spazi e i tab finali da ogni riga dell'output Markdown, e comprime più righe vuote consecutive in una singola riga vuota. Questo mantiene i file puliti ed evita spazi bianchi invisibili che possono influenzare il rendering nei parser Markdown più rigidi — specialmente quello di GitHub, che evidenzia gli spazi bianchi finali come problema di linting. Rende anche l'output più facile da inserire in strumenti di documentazione che eseguono controlli sugli spazi bianchi. L'opzione è sicura da lasciare attiva nella quasi totalità dei casi. Solo in rarissimi casi gli spazi bianchi finali hanno un significato semantico.

Sì. Gli elementi ul e ol annidati vengono elaborati in modo ricorsivo e ogni livello viene correttamente indentato nell'output Markdown. L'annidamento misto — liste ordinate all'interno di liste non ordinate, o viceversa — viene gestito correttamente. Una lista non ordinata con tre livelli di profondità all'interno di una lista ordinata, ad esempio, riceve la corretta indentazione di quattro spazi a ogni livello, che è lo standard CommonMark. Questo è uno dei casi limite in cui i convertitori basati su regex falliscono frequentemente e producono Markdown non funzionante. L'analisi basata sul DOM lo gestisce in modo affidabile.

L'output segue CommonMark con le estensioni GitHub Flavored Markdown (GFM) per tabelle e testo barrato. CommonMark è la specifica standardizzata usata dalla maggior parte delle piattaforme, e GFM aggiunge la sintassi pipe-table e il testo barrato con ~~ che GitHub, GitLab e VS Code supportano tutti. Questo rende l'output compatibile con GitHub, GitLab, VS Code, Notion, Obsidian, Docusaurus, MkDocs e la maggior parte dei moderni renderer Markdown. Se hai bisogno di CommonMark puro senza le estensioni GFM, le tabelle sono l'unico elemento che differirebbe — tutto il resto è identico.

Puoi incollare qualsiasi frammento HTML o il corpo completo di una pagina. Per risultati migliori incolla solo l'area del contenuto principale — non il documento completo con nav, barra laterale e footer — così l'output rimane focalizzato sul contenuto significativo. La maggior parte degli sviluppatori copia solo il div dell'articolo o della documentazione dal pannello Elementi degli Strumenti per sviluppatori del browser (clic destro → Copia → Copia outerHTML). Questo fornisce HTML del contenuto pulito senza la struttura della pagina. Il convertitore gestisce anche HTML di pagine complete, ma l'output includerà il testo di navigazione convertito come un elenco piatto di link, che di solito non è quello che si vuole.

I sistemi AI come Perplexity, ChatGPT e Gemini ora leggono, suddividono e riutilizzano i contenuti web per generare risposte. Markdown è il loro formato di input preferito perché elimina i tag strutturali HTML che consumano token senza aggiungere significato semantico. Un paragrafo racchiuso in tag <p class="article-body"> costa più token dello stesso paragrafo in Markdown semplice. La ricerca pubblicata nel 2024 mostra che Markdown riduce l'uso di token del 68–87% rispetto all'HTML grezzo per lo stesso contenuto — il che riduce direttamente il costo delle API e migliora il rapporto segnale-rumore per le pipeline di retrieval-augmented generation (RAG).

Gli elementi di codice inline (tag code non all'interno di pre) vengono racchiusi tra backtick singoli. I blocchi di codice (elementi pre > code) vengono racchiusi in blocchi delimitati da tripli backtick, lo standard CommonMark e GFM. Se l'elemento code ha una classe come 'language-python' o 'lang-python', l'identificatore del linguaggio viene estratto e preservato nel delimitatore di apertura per l'evidenziazione della sintassi. I blocchi di codice convertiti da pagine README di GitHub o siti di documentazione mantengono i loro tag di linguaggio nell'output — quindi l'evidenziazione della sintassi che avevi in HTML sopravvive nel Markdown.

Markdownify e h2m sono pacchetti npm per Node.js per la conversione programmatica da HTML a Markdown in una pipeline di build. Sono la scelta giusta quando hai bisogno di automatizzare la conversione su centinaia di file in uno script. Questo strumento browser copre il caso d'uso che essi non coprono: conversioni rapide occasionali, contenuti che non puoi condividere con un server e situazioni in cui non vuoi configurare un progetto Node. La qualità della conversione è simile — tutti e tre usano l'analisi basata sul DOM piuttosto che regex — ma questo strumento aggiunge un'anteprima in tempo reale, un pulsante di copia e conteggi di caratteri/parole che lo rendono più pratico per il lavoro sui contenuti.

Sì, il convertitore funziona pienamente sui browser mobile. Incolla HTML dagli appunti, avvia la conversione e copia il risultato Markdown — tutto da un telefono o tablet. L'interfaccia si adatta agli schermi più piccoli con pannelli sovrapposti. Testato su Safari per iOS 17 e Chrome per Android 14. Un caso d'uso mobile comune: prendi l'HTML di un articolo dal menu Condividi del tuo browser, convertilo e incolla il Markdown direttamente in Obsidian o Notion sullo stesso dispositivo, senza aver bisogno di un computer. Nessuna registrazione, nessun download di app, nessun limite.

I commenti HTML (<!-- ... -->) vengono rimossi dall'output poiché Markdown non ha una sintassi per i commenti e i commenti raramente fanno parte del contenuto effettivo. I tag script e i loro contenuti vengono anch'essi eliminati — JavaScript non ha significato in Markdown. I tag style e gli attributi style inline vengono rimossi; lo stile CSS non si traduce in Markdown, e il significato semantico (grassetto, corsivo, intestazione) viene preservato tramite il tipo di elemento piuttosto che lo stile visivo. Se uno span è in grassetto tramite CSS piuttosto che un tag strong o b, quello stile non verrà trasferito — il che è il comportamento corretto per una conversione di formato del contenuto.

No. Non è coinvolto nessun server, quindi non c'è alcun limite di dimensione oltre a ciò che la memoria del tuo browser è in grado di gestire. In pratica, il parser DOM del browser può gestire diversi megabyte di HTML senza problemi — molto più di qualsiasi pagina CMS reale. Se stai convertendo un file HTML molto grande (l'esportazione completa di un libro, un articolo estratto molto lungo), incollalo a sezioni piuttosto che tutto in una volta per ottenere l'output più chiaro. La conversione stessa richiede millisecondi indipendentemente dalla dimensione, perché gira direttamente in JavaScript nella scheda del tuo browser.