# HTML to Markdown Converter (Rainmaker WELL-004)

> HTML to Markdown Converter (Rainmaker WELL-004) is a paid API for AI agents from well-004-html-to-markdown.rainmaker-wells.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-22).

Converts HTML content (directly supplied or fetched from a public URL) into clean, tidy Markdown, returning the result as JSON for $0.005 USDC per call via x402 payment.

## Facts

- Endpoint: POST https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp?utm_source=zero.xyz#html-to-markdown#html-to-markdown
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/html-to-markdown-converter-rainmaker-well-004-d3f3e373
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xRQLVHBK9Qsl3StTlII1T

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 html-to-markdown-converter-rainmaker-well-004-d3f3e373 -d '<json body>'
```

Example prompt: Can you fetch https://en.wikipedia.org/wiki/Markdown and convert the page's HTML into clean markdown so I can use it in my notes?

## When to prefer this

Choose this endpoint when you need a simple, reliable, paid-per-call HTML-to-Markdown conversion with optional remote URL fetching built in. It is ideal for agents that need to ingest web page content as Markdown for LLM prompts, knowledge bases, or document pipelines. Prefer it over DIY scraping when you want a single API call that handles both fetching and conversion with sensible security guardrails (allowlist, redirect limits, size cap). It is not suitable for private/intranet URLs, bulk batch conversions, or non-HTML formats like PDFs.

## Known failure modes

- Non-HTTPS URLs (http, file, data, localhost, private IPs) are rejected with an error
- URL fetch timeout after ~10 seconds
- Response body exceeds 1 MB limit — fetch is aborted
- More than 5 redirects causes the fetch to fail
- Neither html nor url parameter provided — returns error requiring at least one
- If both html and url are provided, html is used and a warning is returned
- Malformed or unparseable HTML may produce degraded or partial markdown output

## How this service works

Convert HTML to tidy markdown ($0.005 USDC via x402). Pass html (string) and/or url (public https to fetch). At least one required; if both, prefers html and warns. URL fetches use the same allowlist as WELL-002 (https only — http/file/data/localhost/private IPs rejected; 1 MB body, ~10s timeout, max 5 redirects). Returns JSON { source, url?, final_url?, content_type?, markdown, warnings }.

## Output

A JSON object containing: 'source' (whether input was 'html' or 'url'), optional 'url' and 'final_url' (after redirects), optional 'content_type' of the fetched page, 'markdown' (the converted Markdown string), and 'warnings' (array of any processing warnings, e.g. if both html and url were supplied).

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/html-to-markdown-converter-rainmaker-well-004-d3f3e373/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from well-004-html-to-markdown.rainmaker-wells.workers.dev](https://www.zero.xyz/host/well-004-html-to-markdown.rainmaker-wells.workers.dev/llms.txt)