---
seo_title: Markdown zu HTML API | Markdown als HTML rendern | EnConvert
meta_desc: Markdown zu HTML rendern via POST /v1/convert/markdown-to-html. Liefert eine komplette gestylte HTML-Seite mit Dark Mode, Tabellen, Codeblöcken und TOC.
keywords: markdown in html umwandeln api, markdown zu html rendern, markdown to html api, md in html konvertieren api, markdown html converter api, markdown rendern api, markdown zu html rest api, md zu html python
---
# Markdown-zu-HTML-API
Die Markdown-zu-HTML-API konvertiert eine Markdown-Datei mit einem einzigen Request an `POST /v1/convert/markdown-to-html` in ein vollständig gestyltes HTML-Dokument. Laden Sie eine `.md`- oder `.markdown`-Datei per Multipart-Formulardaten hoch und erhalten Sie eine komplette, in sich geschlossene HTML-Seite mit eingebettetem CSS, responsivem Layout und integriertem Dark-Mode-Umschalter, bereit zum Öffnen in jedem Browser. Das HTML wird standardmäßig direkt zurückgegeben; setzen Sie `direct_download=false` für JSON-Metadaten mit einer Presigned Download-URL.
---
## Endpunkt
```
POST /v1/convert/markdown-to-html
```
**Content-Type:** `multipart/form-data`
**Akzeptierte Eingabe:** `.md`- oder `.markdown`-Dateien (UTF-8-kodiert)
**Ausgabeformat:** `.html` (`text/html`)
---
## Authentifizierung
Erfordert entweder einen privaten API-Key oder ein per Public Key ausgestelltes JWT-Token.
```
X-API-Key: sk_your_private_key
```
Oder:
```
Authorization: Bearer
```
---
## Request-Parameter
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|------|----------|---------|-------------|
| `file` | file | Ja | -- | Die zu konvertierende `.md`- oder `.markdown`-Datei. Muss UTF-8-kodiert sein. |
| `output_filename` | `string` | Nein | Name der Eingabedatei | Eigener Ausgabedateiname. Die Endung `.html` wird automatisch angehängt. |
| `direct_download` | `boolean` | Nein | `true` | Bei `true` wird das HTML-Dokument direkt zurückgegeben. Bei `false` werden JSON-Metadaten mit einer Presigned Download-URL zurückgegeben. |
---
## Konvertierungsregeln
Der Konverter verwendet Python-Markdown mit folgenden aktivierten Erweiterungen:
| Erweiterung | Funktion |
|-----------|-------------|
| `tables` | Pipe-getrennte Markdown-Tabellen werden als HTML-``-Elemente gerendert |
| `fenced_code` | Codeblöcke mit dreifachen Backticks und Sprachkennung (` ```python `) |
| `codehilite` | Syntax-Highlighting-CSS-Klassen auf Codeblöcken (via Pygments) |
| `toc` | Generierung eines Inhaltsverzeichnisses über einen `[TOC]`-Marker im Dokument |
| `attr_list` | HTML-Attribute per `{.class #id}`-Syntax an Elemente anhängen |
### Beispiel
**Eingabe:**
~~~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!")
```
~~~
**Ausgabe:** Ein vollständiges ``-Dokument mit:
- Dem gerenderten Markdown in einem `` mit 800px max-width und zentriertem Layout
- Gestylten Tabellen, Codeblöcken, Links und Überschriften
- Einem klickbaren, aus den Überschriften generierten Inhaltsverzeichnis
- Einem Dark-Mode-Umschalter (oben rechts), der die Nutzereinstellung in `localStorage` speichert
### Styling der Ausgabe
Das generierte HTML enthält einen eingebetteten `