# ForgeMesh HTML to Markdown Converter

> ForgeMesh HTML to Markdown Converter is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Converts a public web page URL or raw HTML into clean, readable Markdown with navigation, ads, and boilerplate stripped, while respecting robots.txt and AI access preferences.

## Facts

- Endpoint: POST https://x402.forgemesh.io/html-to-markdown
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-html-to-markdown-converter-a03ebf8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TxzypxUaeH4w5Ts9CmPcn

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 forgemesh-html-to-markdown-converter-a03ebf8b -d '<json body>'
```

Example prompt: Can you fetch this article at https://www.example.com/news/article-123 and give me the clean markdown version with just the title, author, and body — no ads or nav menus?

## When to prefer this

Use this endpoint when you need to extract clean, human-readable article content from a public web page or raw HTML for use in summarization pipelines, RAG ingestion, or research agents. It is distinguished by its respect for robots.txt and AI access preferences (aipref/Content-Signal), meaning it will never charge you for pages that disallow agent access. Prefer this over generic scrapers when compliance with site access policies matters.

## Known failure modes

- Target site disallows agent access via robots.txt or aipref — returns 403, no charge
- URL is unreachable or returns a non-200 HTTP status — conversion fails
- HTML is malformed or has no extractable article content — returns empty or minimal markdown
- Neither url nor html provided — returns validation error
- Private or paywalled page that requires authentication — content may not be accessible

## How this service works

HTML to Markdown API: pass a public URL (or raw HTML) and get clean readable markdown back — title, byline, article body with navigation/ads/boilerplate stripped. We honor robots.txt AND Content-Signal (aipref) declarations: a site that disallows agent access returns an unpaid 403, you are never charged. Use for research agents, summarization pipelines, and RAG ingestion.

## Output

Clean Markdown document including the article title, byline, and main body text with navigation menus, advertisements, sidebars, and boilerplate stripped out. If the target site disallows agent access via robots.txt or Content-Signal (aipref), returns a 403 without charging.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Public web page URL"
  },
  "html": {
   "type": "string",
   "description": "Raw HTML alternative to url"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "title": "Micropayment",
  "markdown": "A **micropayment** is a financial transaction..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-html-to-markdown-converter-a03ebf8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)