Markdown in HTML

Markdown in HTML è uno strumento gratuito che converte frammenti Markdown in codice HTML grezzo da usare in siti web, sistemi di gestione dei contenuti e flussi di sviluppo.

Che cosa converte Markdown in HTML?

Converte la formattazione Markdown nei corrispondenti elementi HTML. Un titolo diventa un elemento di intestazione, un link diventa un elemento di ancoraggio e un elenco puntato diventa un elenco non ordinato contenente le relative voci.

Markdown è un formato di markup basato su testo semplice, usato comunemente per file README, documentazione tecnica, descrizioni di problemi e contenuti di siti statici. La conversione in HTML è utile quando il sistema di destinazione richiede HTML anziché Markdown, per esempio un modello di pagina, un sistema di posta elettronica o un campo di un sistema di gestione dei contenuti.

Esistono diversi dialetti Markdown. CommonMark, GitHub Flavored Markdown e i parser specifici delle singole applicazioni possono gestire in modo diverso tabelle, elenchi di attività, interruzioni di riga e HTML incorporato. Le informazioni sullo strumento non indicano un dialetto specifico, quindi verifica la sintassi che va oltre normali titoli, paragrafi, link ed elenchi prima di pubblicare il risultato.

Come si converte Markdown in HTML?

Inserisci il testo sorgente nel campo Markdown, avvia la conversione, quindi leggi o copia il codice generato dal campo HTML.

1. Incolla un frammento completo, non un indicatore di formattazione parziale.
2. Converti il testo e controlla la struttura degli elementi nell'HTML restituito.
3. Verifica link, elenchi annidati e blocchi di codice nell'applicazione che dovrà visualizzarli.
4. Applica separatamente gli stili del sito se la destinazione non dispone già di CSS adeguato.

La conversione avviene sul server. I dati inseriti vengono inviati al server tramite HTTPS e non vengono memorizzati. Poiché il testo lascia il tuo dispositivo per essere elaborato, non inviare credenziali, chiavi private o materiale riservato se le regole della tua organizzazione vietano l'uso di strumenti lato server.

Come si interpreta l'HTML restituito?

Leggi il risultato come codice HTML grezzo, composto da elementi che rappresentano la struttura del Markdown. Potrebbe essere adatto per l'inserimento in una pagina, un modello o un campo di contenuto esistente, ma non è necessariamente un documento HTML completo di doctype, metadati, stili e script.

Ecco un semplice esempio di titolo. Il testo inserito è:

# Release notes

Il risultato HTML convenzionale è:

<h1>Release notes</h1>

Un breve elenco può essere inserito così:

- Alpha

- Beta

La struttura corrispondente è un elenco non ordinato con due elementi:

<ul>

<li>Alpha</li>

<li>Beta</li>

</ul>

La maggior parte degli errori Markdown non genera errori formali del parser. Un indicatore di formattazione senza corrispondenza, un rientro errato o l'assenza di uno spazio dopo un indicatore di elenco possono invece comparire come testo normale. Se l'HTML restituito sembra valido ma la struttura è sbagliata, confronta gli elementi ottenuti con la gerarchia prevista del documento.

• Controlla che i titoli usino il livello previsto e non saltino inutilmente da un livello all'altro.
• Verifica che le voci degli elenchi annidati abbiano un rientro coerente nel sorgente Markdown.
• Controlla le destinazioni dei link prima della pubblicazione, soprattutto quando elabori contenuti di terze parti.
• Esamina con attenzione i blocchi di codice delimitati, perché un delimitatore non chiuso può includere tutto il resto del documento.
• Cerca eventuale HTML grezzo nel sorgente, poiché le diverse implementazioni Markdown possono conservarlo, effettuarne l'escape o rifiutarlo.

Dettagli pratici sulla conversione

La conversione Markdown modifica la struttura, non la lingua del testo. Lettere accentate, alfabeti non latini, numeri e segni di punteggiatura comuni possono rimanere come contenuto testuale all'interno degli elementi generati. I caratteri significativi per HTML potrebbero richiedere la codifica come entità quando devono essere visualizzati letteralmente anziché interpretati come markup.

Spazi e righe vuote possono influire sull'analisi. Una riga vuota separa comunemente i paragrafi, mentre il rientro può creare un elenco annidato o un blocco di codice. Anche la gestione delle interruzioni di riga varia tra i dialetti Markdown, quindi una sola nuova riga nel sorgente non produce sempre un'interruzione visibile in HTML.

Un input vuoto non contiene una struttura significativa da convertire. Per testi molto lunghi può essere preferibile usare un processo di build locale, che consenta di gestire le versioni, eseguire test e mantenere una conversione coerente con lo stesso parser utilizzato in produzione. Nessun convertitore può stabilire se il livello di un titolo, la destinazione di un link o la gerarchia di un elenco siano semanticamente corretti per il tuo progetto.

Quando conviene convertire Markdown in HTML?

La conversione conviene quando il sistema successivo accetta HTML, ma il materiale sorgente è scritto o fornito in Markdown. Tra i casi tipici rientrano il controllo della documentazione di terze parti prima dell'importazione, il debug della build di un sito statico, la preparazione di note di rilascio per un editor che accetta solo HTML e la revisione del markup generato prima della pubblicazione.

In genere non conviene convertire Markdown in HTML quando il contenuto verrà letto soltanto da una macchina e il Markdown funziona già nel formato richiesto. Allo stesso modo, una conversione eseguita troppo presto nel flusso di lavoro può complicare le modifiche successive, se gli autori devono continuare a lavorare in Markdown.

Non minificare l'HTML mentre ne controlli la struttura. Un markup leggibile rende più facile individuare annidamenti errati ed elementi imprevisti. Dopo aver verificato il risultato e averlo preparato per la pubblicazione in produzione, puoi usare il Minificatore HTML per ridurre gli spazi non necessari.

Domande frequenti

L'HTML convertito include anche gli stili CSS?

HTML descrive la struttura, mentre CSS controlla gran parte della presentazione. Lo stesso elemento di intestazione può apparire diverso da un sito all'altro, perché gli stili dipendono dal browser, dall'applicazione o dal tema. Aggiungi o riutilizza il CSS nella destinazione, invece di aspettarti che il sorgente Markdown definisca l'aspetto finale.

Posso convertire tabelle ed elenchi di attività Markdown?

Il supporto dipende dal dialetto Markdown usato dal parser. Le tabelle e le caselle degli elenchi di attività sono estensioni comuni, non una sintassi Markdown universale. Converti un piccolo campione rappresentativo e verifica gli elementi restituiti prima di usarli in un documento più ampio.

È sicuro convertire Markdown proveniente da fonti non attendibili?

Considera non attendibile il Markdown di origine anche dopo la conversione. A seconda del parser e della destinazione, l'HTML incorporato o gli schemi di link non sicuri potrebbero richiedere una sanitizzazione. Questo convertitore cambia il formato, ma la sola conversione non deve essere considerata un filtro di sicurezza.

Posso incollare l'HTML in WordPress o in un altro CMS?

Di solito sì, se l'editor dispone di una vista HTML o codice e consente gli elementi restituiti. Alcuni sistemi di gestione dei contenuti sanitizzano il markup incollato, rimuovono gli attributi non supportati o modificano la spaziatura dei paragrafi. Visualizza un'anteprima e controlla la versione salvata, perché il CMS potrebbe trasformare il contenuto dopo l'invio.

Perché il mio blocco di codice non viene visualizzato correttamente?

Controlla che i delimitatori di apertura e chiusura corrispondano e si trovino su righe separate. Anche i blocchi di codice rientrati possono interrompersi quando il rientro degli elenchi circostanti non è coerente. Se occorre l'evidenziazione della sintassi, la destinazione deve riconoscere l'eventuale identificatore del linguaggio e fornire script o stili propri per applicarla.

Devo conservare il Markdown dopo la conversione?

Conserva il Markdown quando rappresenta il sorgente modificabile di riferimento. Archivia separatamente l'HTML generato oppure ricrealo durante la build, così le modifiche successive non produrranno divergenze tra i due formati. Prima di pubblicare, verifica i link e controlla il frammento nella destinazione effettiva, senza affidarti soltanto al codice grezzo.