# Site To Markdown — REST API endpoint `site-to-markdown`

Convert a full web page's HTML into clean Markdown, the way the Site to Markdown page does: navigation, footers, scripts, styles, iframes and SVG are removed, the content root is <main>, <article> or [role="main"] when present, and headings, lists, links, images, code blocks, blockquotes and tables become Markdown. Pass the page HTML (this tool does not fetch) and optionally the page URL so relative links and images resolve to absolute ones. Returns the markdown plus word, line, and character counts.

- Category: text
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/site-to-markdown/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/site-to-markdown/
- Same tool on the other surface: https://findutils.com/mcp/site-to-markdown/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/site-to-markdown/execute \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<main><h1>Title</h1><p>Hello <a href=\"/x\">link</a></p></main>",
    "url": "https://example.com/"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/site-to-markdown
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `html` | string | yes | The page HTML to convert. A full document or a fragment both work. |
| `url` | string | no | The page's URL, used only to resolve relative links and image sources. Nothing is fetched. |

Example arguments (verified):

```json
{
  "html": "<main><h1>Title</h1><p>Hello <a href=\"/x\">link</a></p></main>",
  "url": "https://example.com/"
}
```

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/
```

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

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