markitdown.ai
Inizia

Convertitore

Convertitore da Markdown in HTML

Markdown in HTML è un convertitore del browser che trasforma CommonMark e GitHub Flavored Markdown in HTML sanitizzato: include intestazioni, tabelle, liste di attività e codice delimitato. Non viene caricato nulla; lo stesso renderer è in esecuzione dietro POST /v1/convert/markdown/html.

# markitdown-ai

Convert documents to clean Markdown.

## Features

- PDF, Word, and slides
- [x] Tables stay tables
- [ ] Mermaid coming later

## Install

```bash
pnpm add @markitdown-ai/sdk
```

## API

| Method | Path |
| --- | --- |
| POST | /v1/convert/{name} |
| GET | /v1/conversions/{id} |

Come si fa

Come convertire Markdown in HTML

Cosa puoi incollare

  • Qualsiasi Markdown: CommonMark più tabelle, liste di attività e barratura di GitHub Flavored Markdown
  • Il rendering avviene nel tuo browser: non viene caricato nulla mentre scrivi
  • Non serve un account per visualizzare l'anteprima, copiare o scaricare
  • Nessun limite di dimensione fisso; un documento molto grande è limitato dalla memoria del tuo browser
Markdown in HTML: un editor Markdown diventa a sinistra una pagina HTML renderizzata

Perché usarlo

Perché usare questo convertitore da Markdown in HTML

Un campo di un CMS, un sito statico e un editor di posta vogliono markup, non codice sorgente Markdown. Questo convertitore conserva le parti che portano significato ed elimina ciò che renderebbe insicuro l'HTML grezzo.

Viene eseguito nel browser

Incolla Markdown e l'anteprima HTML si aggiorna localmente. Non viene caricato nulla e non serve un account per visualizzare in anteprima, copiare o scaricare.

CommonMark più GFM

Intestazioni, liste, link, citazioni e codice delimitato seguono CommonMark; tabelle, liste di attività e barrato seguono GitHub Flavored Markdown.

Sanitizzato per impostazione predefinita

I tag script, i gestori di eventi inline e gli schemi href o src non sicuri vengono rimossi, quindi l'HTML è sicuro da incollare in una pagina che non controlli del tutto.

Frammento o documento completo

Copia solo il markup renderizzato per una pagina che ha già il proprio layout, oppure scarica un documento HTML completo con lo stile dell'anteprima.

Ancore delle intestazioni

Ogni intestazione riceve un id stabile e sicuro per gli URL, generato come fa l'API, così un indice o un link diretto continuano a funzionare dopo la pubblicazione.

Lo stesso motore dell'API

Questa anteprima e POST /v1/convert/markdown/html eseguono lo stesso renderer, quindi l'HTML che copi qui corrisponde byte per byte a una chiamata automatizzata.

Il problema

Perché il Markdown grezzo non può finire direttamente in una pagina web

La sintassi Markdown non è HTML

Un campo di un CMS, un template email o un tema per siti statici vuole markup, non codice sorgente Markdown, quindi il testo grezzo deve essere convertito prima di poter essere stilizzato o incorporato.

Un parser semplice non copre GFM

Tabelle, liste di attività e barrato sono estensioni di GitHub Flavored Markdown; un parser che capisce solo CommonMark le renderizza come barre e tilde letterali invece che come struttura.

Il Markdown non attendibile può veicolare script

Markdown può incorporare HTML grezzo, inclusi tag <script> e gestori di eventi inline, che devono essere rimossi prima che l'output sia sicuro da inserire in una pagina che non controlli del tutto.

Convertire Markdown in HTML: testo incollato male accanto a una struttura Markdown pulita

Cosa viene conservato

Che cosa conserva questo convertitore da Markdown in HTML

Intestazioni e testo inline
Le intestazioni ATX e setext, l'enfasi, i link e le citazioni seguono CommonMark; ogni intestazione riceve anche un id sicuro per gli URL generato dal suo testo.Source: CommonMark Spec
Tabelle, liste di attività e barrato
Le tabelle di GitHub Flavored Markdown diventano elementi <table>, gli elementi [ ] e [x] diventano caselle di controllo e ~~testo~~ diventa <del>.Source: GitHub Flavored Markdown Spec
Markup sanitizzato
I tag <script> grezzi, i gestori di eventi inline e i valori href o src al di fuori di http, https e mailto vengono rimossi prima di restituire l'HTML.Source: HTML Living Standard
Codice delimitato
I blocchi di codice delimitato conservano il contenuto e l'etichetta di linguaggio; l'anteprima nel browser non applica alcun tema di evidenziazione della sintassi.Source: CommonMark Spec
HTML grezzo nella sorgente
Il Markdown che incorpora altri tag HTML grezzi passa attraverso lo stesso sanitizzatore, quindi un tag incorporato non viene mai trattato come markup attendibile.Source: HTML Living Standard

Estratto verificato di Markdown in HTML· https://markitdown.ai/blog/why-pdfs-break-llms

<h2 id="what-actually-goes-wrong">What actually goes wrong</h2><p>When teams pipe documents straight into an LLM or a retrieval index, a few failure modes show up again and again:</p><ul><li><strong>Reading order breaks.</strong> Multi-column layouts interleave. A two-column page becomes "line 1 left, line 1 right, line 2 left, line 2 right…", so a sentence a human reads top-to-bottom arrives at the model scrambled.</li><li><strong>Tables collapse.</strong> Copy-paste turns a table into a loose run of numbers. The relationship between a header and its cell — the entire point of a table — is gone.</li><li><strong>Headings disappear.</strong> The visual hierarchy (this is a section, this is a subsection) is encoded as font size and weight, not structure. Strip the styling and you get one undifferentiated wall of text.</li><li><strong>Noise creeps in.</strong> Page numbers, running headers, hyphenated line breaks, and stray ligatures end up inline, polluting prompts and embeddings alike.</li></ul><p>Read more in the <a href="https://markitdown.ai/blog/why-pdfs-break-llms">full article</a>.</p>

Casi d'uso

Casi d'uso della conversione da Markdown in HTML

Ovunque una destinazione voglia markup mentre la sorgente resta Markdown, questo convertitore è il passaggio intermedio.

Documentazione e siti statici

Trasforma un README o un articolo Markdown di una knowledge base nell'HTML che un generatore di siti statici o un campo di un CMS si aspetta.

Bozze di email e newsletter

Scrivi un messaggio in Markdown, convertilo in HTML, poi incolla il frammento nell'editor di posta da cui lo invii davvero.

Pulire la risposta di un LLM

ChatGPT, Claude e Gemini restituiscono Markdown; convertilo in HTML quando la destinazione — un ticket, una pagina wiki — renderizza markup invece di asterischi grezzi.

Sviluppatori che automatizzano il rendering

Chiama l'endpoint di rendering da una pipeline che memorizza Markdown ma serve HTML, senza aggiungere una libreria Markdown a ogni servizio.

Markdown in HTML online: la pagina renderizzata viene usata in siti, email e documenti

API

API di Markdown in HTML per sviluppatori

Il rendering viene eseguito in modo sincrono e costa 0 crediti — conta comunque ai fini del limite di richieste al minuto del tuo piano. Invia Markdown come testo, oppure fai riferimento a un file .md memorizzato, a POST /v1/convert/markdown/html con la tua chiave API; l'HTML sanitizzato torna nella stessa risposta.

Leggi la guida API
curl -X POST https://api.markitdown.ai/v1/convert/markdown/html \  -H "x-api-key: mdai_…" \  -H "Content-Type: application/json" \  -d '{ "text": "# Notes\n\nHello **world**." }'

Guida

Documentazione e siti statici

La maggior parte degli strumenti di documentazione mantiene Markdown come sorgente modificabile e genera HTML solo in fase di build o di anteprima. Questo convertitore ti permette di verificare quel passaggio di generazione in isolamento: incolla lo stesso Markdown che leggerà il generatore del tuo sito e conferma che intestazioni, tabelle e blocchi di codice escano come il tuo tema si aspetta prima di confermare una modifica. È utile anche quando un campo di un CMS accetta HTML ma i tuoi redattori lavorano in Markdown: converti una volta, incolla il frammento e continua a modificare la sorgente Markdown per la revisione successiva invece di correggere a mano il markup generato.

  • Mantieni il file Markdown come tua fonte di verità; considera l'HTML come un artefatto di build.
  • Confronta l'output renderizzato con il tema reale del tuo sito, non solo con lo stile dell'anteprima di questa pagina.
  • Riesegui la conversione dopo ogni modifica alla sorgente invece di correggere a mano l'HTML generato.

Sanitizzazione

Markdown può incorporare HTML grezzo, e quell'HTML grezzo può includere un tag <script> o un gestore di eventi inline come onclick. Prima che questo convertitore restituisca un risultato, quel markup passa attraverso un sanitizzatore che rimuove gli elementi script, elimina qualsiasi attributo che inizi con "on" e consente solo link e sorgenti di immagini http, https e mailto. Ciò che sopravvive è la struttura semantica — intestazioni, paragrafi, liste, tabelle, link, immagini e codice — non lo stile decorativo. Il convertitore non inietta una classe o un file CSS nell'output del frammento; il download di un documento completo aggiunge il tema che vedi nell'anteprima, così il file si apre correttamente da solo.

Frammento o pagina completa

Un frammento è il markup interno — le intestazioni, i paragrafi e le tabelle — senza i tag <html> o <head> circostanti. Appartiene a una pagina che definisce già la propria struttura e il proprio stile, come un campo di contenuto di un CMS o un componente che renderizza elementi figli. Un documento completo aggiunge un doctype, un titolo e un piccolo foglio di stile, così il file può essere aperto direttamente in un browser o salvato da solo. Incollare un documento completo in un campo di contenuto che si aspetta un frammento è un errore comune: il browser potrebbe comunque renderizzarlo, ma i tag <html> e <head> annidati non sono validi lì e possono confondere gli strumenti a valle che si aspettano un frammento.

Altri convertitori Markdown

Need it in your code? Use the developer API. Converting at scale? See plans and pricing.

FAQ

Domande su Markdown in HTML

Come funziona Markdown in HTML?

Incolla o digita Markdown e il convertitore renderizza HTML sanitizzato localmente nel browser, usando lo stesso renderer di POST /v1/convert/markdown/html. Non viene caricato nulla mentre scrivi.

Markdown in HTML supporta GitHub Flavored Markdown?

Sì. Tabelle, liste di attività e barrato seguono la specifica GitHub Flavored Markdown, insieme a intestazioni, liste, link e codice di CommonMark.

L'output HTML è sanitizzato?

Sì. I tag script, i gestori di eventi inline e gli schemi href o src non sicuri vengono rimossi, quindi l'HTML è sicuro da incollare in una pagina che non controlli del tutto.

Posso ottenere un documento HTML completo invece di un frammento?

Sì. Scegli un documento completo con lo stile dell'anteprima, oppure copia solo il frammento per una pagina che ha già il proprio layout.

Serve un account per convertire Markdown in HTML?

No. Anteprima, copia e download funzionano senza accedere, perché il rendering avviene localmente nel browser.

Questa pagina chiama l'API mentre scrivo?

No. La digitazione resta locale. L'API viene eseguita solo quando chiami direttamente POST /v1/convert/markdown/html, per esempio da uno script.

Esiste un limite di dimensione per il Markdown che converto?

Non c'è un limite di caricamento fisso perché non viene caricato nulla; i limiti pratici dipendono dalla memoria del browser per documenti molto grandi.

Posso convertire Markdown in HTML dal codice?

Sì. Invia il tuo Markdown come testo, oppure un file .md memorizzato, a /v1/convert/markdown/html con una chiave API. Costa 0 crediti. Consulta /developers.

Converti Markdown in HTML ovunque.

Provalo gratis: non serve registrarsi.

IniziaApri il convertitore