# Tanod Web HTML to Text/Markdown Converter

> Tanod Web HTML to Text/Markdown Converter is a paid API for AI agents from web.tanod.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Converts raw HTML markup into clean Markdown or plain text, resolving relative links to absolute URLs if a base URL is provided.

## Facts

- Endpoint: POST https://web.tanod.dev/v1/html-to-text?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-web-html-to-text-markdown-converter-02f9c3d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qvxe1nynRnR28qg1bLFYH

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 tanod-web-html-to-text-markdown-converter-02f9c3d4 -d '<json body>'
```

Example prompt: Take this HTML I have and convert it to Markdown — here's the content: '<html><body><h1>Hello</h1><p>World <a href="/docs">docs</a></p></body></html>' — use https://example.com as the base URL so relative links become absolute.

## When to prefer this

Use this endpoint when you already have HTML content in memory and need to convert it to readable Markdown or plain text without fetching any URLs. Ideal for post-scrape processing pipelines, LLM context preparation, or readable text extraction from HTML strings. Prefer this over a full-page fetch+convert endpoint when you control the HTML source. Choose markdown output for structured preservation (headings, links, bold); choose plain text when feeding to models that don't benefit from Markdown syntax.

## Known failure modes

- HTML input exceeds 2 MB limit — request rejected
- Empty or missing html field — validation error
- Malformed JSON body — bad request error
- Extremely large or deeply nested HTML may produce truncated output (truncated: true in response)
- Invalid format enum value (not 'markdown' or 'text') — validation error

## How this service works

Web tools: search, page to Markdown or screenshot, company profile and jobs, sitemaps, RDAP, IP.

## Output

Returns a JSON object containing: the converted content string (Markdown or plain text), the output format used, character count, page title, page description, a truncation flag indicating if the content was cut off, and library provenance metadata (BeautifulSoup, MIT license). The content field is the primary output.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "html": {
   "type": "string",
   "maxLength": 2000000,
   "minLength": 1,
   "description": "The HTML document itself (at most 2 MB UTF-8); nothing is fetched."
  },
  "format": {
   "enum": [
    "text",
    "markdown"
   ],
   "type": "string",
   "default": "markdown",
   "description": "markdown (default) or plain text."
  },
  "base_url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Makes relative links absolute in the output; never fetched."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chars": 67,
  "title": "",
  "format": "markdown",
  "source": {
   "library": "BeautifulSoup (html.parser)",
   "license": "MIT"
  },
  "content": "# Title\n\nSome **bold** text and a [link](https://example.com/docs).",
  "truncated": false,
  "description": "",
  "untrusted_content": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-web-html-to-text-markdown-converter-02f9c3d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from web.tanod.dev](https://www.zero.xyz/host/web.tanod.dev/llms.txt)