> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /markdown-to-html

> Converta Markdown em HTML limpo e sanitizado. Suporta GFM, tabelas, destaque de código e mais.

## Endpoint

```
POST https://api.bunny.build/api/v1/markdown-to-html
```

## Autenticação

| Header         | Obrigatório | Valor                        |
| -------------- | ----------- | ---------------------------- |
| `X-API-Key`    | Sim         | Sua chave de API (`bun_...`) |
| `Content-Type` | Sim         | `application/json`           |

## Visão geral

Converta código-fonte Markdown em HTML sanitizado pronto para renderização em navegadores ou clientes de e-mail. Suporta GitHub Flavored Markdown (GFM), tabelas, listas de tarefas, blocos de código delimitados com destaque de sintaxe e tachado. A saída é sanitizada para prevenir XSS.

## Casos de uso

* Renderizar conteúdo Markdown gerado por usuários com segurança em aplicações web
* Converter arquivos README ou de documentação para HTML
* Processar rascunhos de posts de blog escritos em Markdown
* Gerar e-mails HTML a partir de templates em Markdown

## Detalhes

A análise segue a especificação CommonMark com extensões GFM. O HTML presente na entrada é sanitizado. Blocos de código são envoltos em tags `<pre><code>` com uma classe de linguagem para destaque baseado em CSS.

## Corpo da requisição

| Campo      | Tipo   | Obrigatório | Descrição                  |
| ---------- | ------ | ----------- | -------------------------- |
| `markdown` | string | Sim         | Texto Markdown a converter |

### Exemplo

````json theme={null}
{
  "markdown": "# Hello\n\nThis is **bold** and _italic_ text.\n\n```js\nconsole.log('hi');\n```"
}
````

## Resposta

### 200 OK

| Campo  | Tipo   | Descrição                     |
| ------ | ------ | ----------------------------- |
| `html` | string | HTML renderizado e sanitizado |

**Exemplo**

```json theme={null}
{
  "html": "<h1>Hello</h1>\n<p>This is <strong>bold</strong> and <em>italic</em> text.</p>\n<pre><code class=\"language-js\">console.log('hi');\n</code></pre>"
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

```json theme={null}
{
  "detail": "Missing required field: markdown"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST https://api.bunny.build/api/v1/markdown-to-html \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello\n\nThis is **bold** text."}'
```