Site To Markdown API

POST https://api.findutils.com/api/tools/site-to-markdown/execute

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.

Open the tool Try it

Request body

application/json

html

string required

The page HTML to convert. A full document or a fragment both work.
url

string optional

The page's URL, used only to resolve relative links and image sources. Nothing is fetched.

Example arguments

Verified

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

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/"
  }'

const response = await fetch('https://api.findutils.com/api/tools/site-to-markdown/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"html":"<main><h1>Title</h1><p>Hello <a href=\"/x\">link</a></p></main>","url":"https://example.com/"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/site-to-markdown/execute",
    json={"html":"<main><h1>Title</h1><p>Hello <a href=\"/x\">link</a></p></main>","url":"https://example.com/"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/site-to-markdown/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"html":"<main><h1>Title</h1><p>Hello <a href=\"/x\">link</a></p></main>","url":"https://example.com/"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call site_to_markdown from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: site-to-markdown
MCP name: site_to_markdown
Category: Text
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Text tools

More to explore