$ man html-to-markdown
/html-to-markdown(1)
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
uncategorized
STATUS
● live
NAME
html-to-markdown — html → markdown converter
SYNOPSIS
POST https://x402.org/v1/html-to-markdown
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
HTML → Markdown converter. Accepts raw HTML or a URL. Strips nav/script/style/ad noise. Preserves headings, lists, tables, code blocks, links, images.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| html | string | Raw HTML to convert. Mutually exclusive with 'url' — supply one. | optional |
| url | string | Page URL to fetch and convert. Server follows redirects. Mutually exclusive with 'html'. | optional |
| include_links | boolean | Keep hyperlinks as Markdown [text](href). Default true. Set false for prose-only output. | optional |
| include_images | boolean | Keep images as Markdown . Default true. | optional |
| user_agent | string | Optional User-Agent header sent when fetching 'url'. Default is a generic browser UA. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| title | string | Page title extracted from the HTML <title> tag or first heading. |
| markdown_chars | string | Character count of the converted markdown output. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/html-to-markdown \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the html-to-markdown tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- mediakithtml-to-markdownmarkdown-convertercontent-extractionurl-to-markdownreadabilityscraping
- methods
- POST
- cluster
- mediakit
- price
- $0.005 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| compress-pdf | PDF compressor / PDF size reducer. | $0.005 |
| convert-html-to-markdown | Convert HTML to Markdown. | $0.005 |
| excel-to-csv | Excel (.xlsx / .xls) → CSV / TSV / JSON converter. | $0.005 |
| excel-to-google-sheets | Convert Excel to Google Sheets / XLSX to Google Sheets / spreadsheet import / Numbers to Google Sheets / Excel to gsheet. | $0.005 |
| pdf-compress | PDF compressor / shrink PDF / PDF size reducer / smaller PDF for email. | $0.005 |
| xlsx-to-csv | Excel to CSV / XLSX to CSV / Numbers to CSV / spreadsheet to CSV. | $0.005 |
| json-yaml | JSON ↔ YAML bidirectional converter. | $0.002 |
| audio-transcribe | Audio transcribe / speech-to-text / Whisper-large / multi-language ASR / OpenAI Whisper API compat. | $0.01 |
SEE ALSO