Come convertire HTML in Markdown

A cosa serve la conversione da HTML a Markdown

Questo strumento serve a trasformare un contenuto HTML in testo con sintassi simile a Markdown, così puoi riutilizzare più facilmente titoli, collegamenti, immagini e formattazione in un documento compatibile. Inserisci il contenuto HTML nell’area di testo e usa la conversione quando vuoi ottenere una versione più leggibile e leggera. Il risultato dipende dalle strutture e dagli attributi riconosciuti: non si comporta come un parser HTML completo.

Procedura passo passo

1. Prepara il contenuto HTML che vuoi convertire. Puoi includere titoli dal livello 1 al livello 6, paragrafi, collegamenti, immagini, elementi di formattazione, liste, citazioni e blocchi di codice.
2. Incolla il contenuto nel campo di testo. Il campo è facoltativo: se lo lasci vuoto o non inserisci nulla, l’operazione termina correttamente e restituisce un risultato vuoto.
3. Avvia la conversione.
4. Esamina il testo prodotto. I titoli ricevono i prefissi Markdown corrispondenti; i collegamenti e alcune immagini diventano la relativa sintassi Markdown; gli elementi strong, b, em e i senza attributi vengono convertiti in marcatori di enfasi. La struttura esatta <pre><code>...</code></pre> diventa un blocco di codice delimitato, mentre gli elementi code compatibili diventano codice in linea.
5. Controlla le liste, le citazioni, i paragrafi, le interruzioni di riga e gli altri blocchi. Il convertitore applica trasformazioni solo a determinati schemi. Dopo queste trasformazioni, la sintassi dei tag riconosciuta come rimanente viene rimossa, mentre il testo contenuto al loro interno viene conservato. Le entità nominate selezionate e i riferimenti numerici decimali validi vengono decodificati.

Come leggere e verificare il risultato

Leggi il risultato come una trasformazione basata su schemi riconosciuti, non come una riscrittura di ogni possibile documento HTML. Gli attributi presenti su elementi di enfasi, le varianti nella struttura dei blocchi, i diversi annidamenti o una forma diversa degli attributi di collegamenti e immagini possono impedire la conversione prevista. Anche il testo racchiuso in tag non convertiti può restare senza la formattazione attesa dopo la rimozione della sintassi dei tag.

La spaziatura esterna viene ripulita: gli spazi iniziali e finali vengono eliminati e sequenze di almeno quattro interruzioni di riga vengono ridotte a tre. Presta particolare attenzione ai riferimenti numerici decimali: quelli nella forma composta soltanto da cifre possono causare un errore se il valore supera l’intervallo accettato dalla conversione dei caratteri; altre forme non valide possono invece restare invariate.

Esempio pratico

Stai preparando una nota tecnica e vuoi trasformare il titolo, il collegamento alla documentazione e un esempio di comando da HTML a una versione Markdown più facile da modificare.

Inserisci un breve contenuto con un titolo, un collegamento e una struttura <pre><code>...</code></pre>, quindi avvia la conversione e controlla la forma del testo restituito.

Il risultato ha la forma di testo Markdown: il titolo è preceduto dal relativo prefisso, il collegamento usa la sintassi Markdown e il blocco di codice appare delimitato.

Limiti

• La conversione è limitata agli schemi HTML esplicitamente riconosciuti. Varianti di attributi, annidamenti o strutture possono restare non convertite; alcuni riferimenti numerici decimali possono causare un errore.

Errori comuni

• Se una parte resta senza la sintassi Markdown prevista, la causa probabile è una struttura o un attributo diverso dallo schema riconosciuto. Verifica la forma del tag e prova a semplificare gli attributi o l’annidamento prima di ripetere la conversione.

Domande frequenti

Cosa succede se non inserisco HTML?

Sì, quando il testo è omesso o vuoto l’operazione termina correttamente e il risultato convertito è vuoto.

Quali elementi HTML vengono convertiti?

Vengono gestiti alcuni titoli, collegamenti, immagini, elementi di enfasi, liste, citazioni e blocchi di codice. Le varianti con attributi, annidamenti o strutture non riconosciuti possono non essere convertite nello stesso modo.

I riferimenti numerici HTML vengono sempre decodificati?

Un riferimento nella forma &#cifre; può generare un errore se il valore non rientra nell’intervallo valido per la conversione dei caratteri; forme numeriche non conformi possono invece restare invariate.