# Markdown To Html — REST API endpoint `markdown-to-html`

Convert Markdown to HTML, including GFM tables, task lists, nested lists, strikethrough, fenced code and autolinks. Raw HTML in the source is escaped rather than passed through, and link and image destinations are restricted to http, https, mailto and tel.

- Category: text
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, API key for tools/call, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/markdown-to-html/execute (API key, 60 req/min per IP)
- API key: Running a tool needs an API key. Keys are not for sale yet: ask for early access. Without a key, a tool call answers HTTP 402 Payment Required with the error code PAYMENT_REQUIRED. The catalog and the schemas stay open without a key. https://findutils.com/api/#api-keys
- Reference page: https://findutils.com/api/markdown-to-html/
- Same tool on the other surface: https://findutils.com/mcp/markdown-to-html/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/markdown-to-html/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Release notes\n\n| Tool | Status |\n|------|--------|\n| Markdown to HTML | live |\n\n- [x] tables\n- [ ] footnotes\n"
  }'

# Parameter schema (no key needed)
curl https://api.findutils.com/api/tools/markdown-to-html
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `markdown` | string | yes | Markdown source. |
| `fullDocument` | boolean | no | Wrap the output in a minimal HTML5 document (doctype, charset, viewport, title). Default false, which returns a fragment you can paste into a CMS field or a template. Default: `false`. |
| `title` | string | no | Title for the wrapped document. Ignored unless fullDocument is true. Defaults to the first H1, then to "Document". |

Example arguments (verified):

```json
{
  "markdown": "# Release notes\n\n| Tool | Status |\n|------|--------|\n| Markdown to HTML | live |\n\n- [x] tables\n- [ ] footnotes\n"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/ --header "Authorization: Bearer YOUR_API_KEY"
```

Then ask the client to call `findutils:markdown_to_html`. Full MCP reference: https://findutils.com/mcp/markdown-to-html/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt