---
seo_title: API de Markdown a HTML | Renderiza Markdown a HTML | EnConvert
meta_desc: Renderiza Markdown a HTML con POST /v1/convert/markdown-to-html. Recibe una página HTML completa con estilos, modo oscuro, tablas, bloques de código y TOC.
keywords: api markdown a html, convertir markdown a html, renderizar markdown a html api, markdown a html api rest, md a html api, markdown a html python, api de renderizado de markdown
---
# API de Markdown a HTML
La API de Markdown a HTML convierte un archivo Markdown en un documento HTML con estilos completos con una sola solicitud a `POST /v1/convert/markdown-to-html`. Sube un archivo `.md` o `.markdown` mediante un formulario multipart y recibe una página HTML completa y autocontenida con CSS incrustado, diseño responsivo y un botón de modo oscuro integrado, lista para abrir en cualquier navegador. El HTML se devuelve directamente por defecto, o establece `direct_download=false` para obtener metadatos JSON con una URL de descarga prefirmada.
---
## Endpoint
```
POST /v1/convert/markdown-to-html
```
**Content-Type:** `multipart/form-data`
**Entrada aceptada:** archivos `.md` o `.markdown` (codificados en UTF-8)
**Formato de salida:** `.html` (`text/html`)
---
## Autenticación
Requiere una clave API privada o un token JWT obtenido de una clave pública.
```
X-API-Key: sk_your_private_key
```
O bien:
```
Authorization: Bearer
```
---
## Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|-----------|------|----------|---------|-------------|
| `file` | file | Sí | -- | El archivo `.md` o `.markdown` a convertir. Debe estar codificado en UTF-8. |
| `output_filename` | `string` | No | Nombre del archivo de entrada | Nombre de archivo de salida personalizado. La extensión `.html` se añade automáticamente. |
| `direct_download` | `boolean` | No | `true` | Con `true`, devuelve el documento HTML directamente. Con `false`, devuelve metadatos JSON con una URL de descarga prefirmada. |
---
## Reglas de conversión
El conversor usa Python-Markdown con las siguientes extensiones habilitadas:
| Extensión | Qué hace |
|-----------|-------------|
| `tables` | Tablas Markdown delimitadas por barras verticales renderizadas como elementos `` de HTML |
| `fenced_code` | Bloques de código con triple acento grave e identificadores de lenguaje (` ```python `) |
| `codehilite` | Clases CSS de resaltado de sintaxis en los bloques de código (mediante Pygments) |
| `toc` | Generación de tabla de contenidos mediante un marcador `[TOC]` en tu documento |
| `attr_list` | Añade atributos HTML a los elementos con la sintaxis `{.class #id}` |
### Ejemplo
**Entrada:**
~~~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!")
```
~~~
**Salida:** Un documento `` completo con:
- El Markdown renderizado dentro de un `` con ancho máximo de 800px y diseño centrado
- Tablas, bloques de código, enlaces y encabezados con estilos
- Una tabla de contenidos clicable generada a partir de los encabezados
- Un botón de modo oscuro (esquina superior derecha) que guarda la preferencia del usuario en `localStorage`
### Estilos de salida
El HTML generado incluye un bloque `