# boring-api · convert: HTML to Markdown

> boring-api · convert: HTML to Markdown is a paid API for AI agents from convert.boring-api.com, paid per call via x402, $0.0008/call, status unknown (last checked 2026-09-15).

Converts HTML content to Markdown format using document conversion libraries

## Facts

- Endpoint: POST https://convert.boring-api.com/html-to-markdown
- Price: $0.0008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boring-api-convert-html-to-markdown-6baaa213
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__k5JccTdqgT1UNunuLI4W

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability boring-api-convert-html-to-markdown-6baaa213 -d '<json body>'
```

Example prompt: Convert this HTML to Markdown for me: '<h1>Hello World</h1><p>This is a <strong>bold</strong> paragraph with a <a href="https://example.com">link</a>.</p>'

## When to prefer this

Use this endpoint when you need a reliable, pay-per-call HTML-to-Markdown conversion without managing Pandoc or headless browser infrastructure yourself. Ideal for agents processing web-scraped HTML, converting CMS output, or preparing content for LLM consumption where Markdown is preferred over raw HTML.

## Known failure modes

- Malformed or unparseable HTML may produce garbled Markdown output
- Very large HTML documents may time out or return incomplete results
- Deeply nested or complex HTML structures may not map cleanly to Markdown
- Missing or empty 'content' field returns an error
- HTML with inline scripts or styles may produce noisy Markdown output

## How this service works

Document and data format conversions via Pandoc, Chromium-headless, and pure-JS libs. Text inputs/outputs are JSON-fielded; binary inputs/outputs use base64 in JSON for uniformity.

## Output

A JSON object containing the Markdown-formatted equivalent of the submitted HTML content, with HTML tags translated into appropriate Markdown syntax (headings, bold, links, lists, etc.)

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "content": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boring-api-convert-html-to-markdown-6baaa213/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convert.boring-api.com](https://www.zero.xyz/host/convert.boring-api.com/llms.txt)
