---
seo_title: API Markdown in HTML | Converti Markdown in HTML | EnConvert
meta_desc: Converti Markdown in HTML con POST /v1/convert/markdown-to-html. Ottieni una pagina HTML completa con stili, dark mode, tabelle, blocchi di codice e TOC.
keywords: markdown in html api, convertire markdown in html, api rendering markdown, markdown to html rest api, md in html api, markdown in html python, api conversione markdown html, generare html da markdown api
---
# API Markdown in HTML
L'API Markdown in HTML converte un file Markdown in un documento HTML completamente stilizzato con una singola richiesta a `POST /v1/convert/markdown-to-html`. Carica un file `.md` o `.markdown` tramite multipart form data e ricevi una pagina HTML completa e autonoma con CSS incorporato, layout responsive e un toggle integrato per la dark mode, pronta da aprire in qualsiasi browser. L'HTML viene restituito direttamente per impostazione predefinita, oppure imposta `direct_download=false` per metadati JSON con un URL di download prefirmato.
---
## Endpoint
```
POST /v1/convert/markdown-to-html
```
**Content-Type:** `multipart/form-data`
**Input accettato:** file `.md` o `.markdown` (codificati in UTF-8)
**Formato di output:** `.html` (`text/html`)
---
## Autenticazione
Richiede una chiave API privata oppure un token JWT ottenuto da una chiave pubblica.
```
X-API-Key: sk_your_private_key
```
Oppure:
```
Authorization: Bearer
```
---
## Parametri della richiesta
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| `file` | file | Sì | -- | Il file `.md` o `.markdown` da convertire. Deve essere codificato in UTF-8. |
| `output_filename` | `string` | No | Nome file di input | Nome file di output personalizzato. L'estensione `.html` viene aggiunta automaticamente. |
| `direct_download` | `boolean` | No | `true` | Con `true`, restituisce il documento HTML direttamente. Con `false`, restituisce metadati JSON con un URL di download prefirmato. |
---
## Regole di conversione
Il convertitore usa Python-Markdown con le seguenti estensioni abilitate:
| Estensione | Cosa fa |
|-----------|-------------|
| `tables` | Tabelle Markdown delimitate da pipe renderizzate come elementi HTML `` |
| `fenced_code` | Blocchi di codice con tripli backtick e identificatori di linguaggio (` ```python `) |
| `codehilite` | Classi CSS di syntax highlighting sui blocchi di codice (tramite Pygments) |
| `toc` | Generazione dell'indice tramite un marcatore `[TOC]` nel documento |
| `attr_list` | Aggiunge attributi HTML agli elementi con la sintassi `{.class #id}` |
### Esempio
**Input:**
~~~markdown
# My Document
[TOC]
## Introduction
This is a **bold** and *italic* example.
## Data Table
| Name | Age | City |
|-------|-----|--------|
| Alice | 30 | London |
| Bob | 25 | Paris |
## Code Sample
```python
def hello():
print("Hello, world!")
```
~~~
**Output:** un documento `` completo con:
- Il Markdown renderizzato dentro un `` con max-width di 800px e layout centrato
- Tabelle, blocchi di codice, link e intestazioni con stili
- Un indice cliccabile generato dalle intestazioni
- Un pulsante di attivazione della dark mode (angolo in alto a destra) che salva la preferenza dell'utente in `localStorage`
### Stili dell'output
L'HTML generato include un blocco `