---
seo_title: API Markdown vers HTML | Rendu Markdown en HTML | EnConvert
meta_desc: Rendez du Markdown en HTML via POST /v1/convert/markdown-to-html. Page HTML complète et stylée avec mode sombre, tableaux, blocs de code et table des matières.
keywords: api markdown vers html, convertir markdown en html, rendu markdown en html api, convertisseur markdown html api, markdown vers html api rest, md en html api, markdown en html python requests, api rendu markdown
---
# API Markdown vers HTML
L'API Markdown vers HTML convertit un fichier Markdown en un document HTML entièrement stylé en une seule requête vers `POST /v1/convert/markdown-to-html`. Envoyez un fichier `.md` ou `.markdown` en multipart form data et recevez une page HTML complète et autonome, avec CSS embarqué, mise en page responsive et bascule de mode sombre intégrée, prête à ouvrir dans n'importe quel navigateur. Le HTML est renvoyé directement par défaut, ou définissez `direct_download=false` pour des métadonnées JSON avec une URL de téléchargement présignée.
---
## Endpoint
```
POST /v1/convert/markdown-to-html
```
**Content-Type :** `multipart/form-data`
**Entrée acceptée :** fichiers `.md` ou `.markdown` (encodés en UTF-8)
**Format de sortie :** `.html` (`text/html`)
---
## Authentification
Nécessite une clé API privée ou un token JWT obtenu à partir d'une clé publique.
```
X-API-Key: sk_your_private_key
```
Ou :
```
Authorization: Bearer
```
---
## Paramètres de requête
| Paramètre | Type | Obligatoire | Défaut | Description |
|-----------|------|----------|---------|-------------|
| `file` | file | Oui | -- | Le fichier `.md` ou `.markdown` à convertir. Doit être encodé en UTF-8. |
| `output_filename` | `string` | Non | Nom du fichier d'entrée | Nom de fichier de sortie personnalisé. L'extension `.html` est ajoutée automatiquement. |
| `direct_download` | `boolean` | Non | `true` | À `true`, renvoie le document HTML directement. À `false`, renvoie des métadonnées JSON avec une URL de téléchargement présignée. |
---
## Règles de conversion
Le convertisseur utilise Python-Markdown avec les extensions suivantes activées :
| Extension | Rôle |
|-----------|-------------|
| `tables` | Les tableaux Markdown délimités par des barres verticales sont rendus en éléments HTML `` |
| `fenced_code` | Blocs de code à triple backtick avec identifiants de langage (` ```python `) |
| `codehilite` | Classes CSS de coloration syntaxique sur les blocs de code (via Pygments) |
| `toc` | Génération d'une table des matières via un marqueur `[TOC]` dans votre document |
| `attr_list` | Ajout d'attributs HTML aux éléments avec la syntaxe `{.class #id}` |
### Exemple
**Entrée :**
~~~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!")
```
~~~
**Sortie :** un document `` complet avec :
- Le Markdown rendu dans un `` avec largeur max de 800px et mise en page centrée
- Tableaux, blocs de code, liens et titres stylés
- Une table des matières cliquable générée à partir des titres
- Un bouton de bascule de mode sombre (coin supérieur droit) qui conserve la préférence de l'utilisateur dans `localStorage`
### Style de sortie
Le HTML généré inclut un bloc `