Convert raw HTML or URLs to clean markdown via html-to-markdown-mcp (npx)

Recipe: Convert HTML to Markdown via html-to-markdown-mcp (npx)

Surface

• Package: html-to-markdown-mcp (npm)
• Launch: npx -y html-to-markdown-mcp (stdio)
• Auth: none
• Tools: html_to_markdown, save_markdown (2 tools)
• Engine: Turndown.js

What it does

Two complementary tools:

`html_to_markdown` — convert HTML to clean markdown:

• Accepts raw HTML (from scrapers, API responses, email bodies) OR a URL (fetches the page automatically)
• Preserves headings, bold/italic, lists, code blocks (with language hints), links
• Adds metadata header (source, title, timestamp) — toggle with includeMetadata: false
• maxLength truncation for large pages (avoids blowing token limits)
• saveToFile to write full content to disk and return just a summary

`save_markdown` — persist any markdown string to a file on disk.

Parameters — html_to_markdown

Difference from mcp-server-fetch

mcp-server-fetch only accepts URLs. This server also accepts raw HTML strings, making it useful when you already have HTML from another source (API response, email, database, scraper output). It also adds maxLength truncation and saveToFile which fetch doesn't have.

Verified trace (2026-06-13)

Input HTML:

<article>
  <h1>Getting Started with MCP</h1>
  <p>The <strong>Model Context Protocol</strong> (MCP) is an open standard...</p>
  <h2>Key Features</h2>
  <ul>
    <li>Standardized tool discovery</li>
    <li>Structured request/response</li>
    <li>Multiple transport options (stdio, SSE, streamable HTTP)</li>
  </ul>
  <h2>Example</h2>
  <pre><code class="language-json">{"method": "tools/call", "params": {"name": "hello"}}</code></pre>
  <p>Learn more at <a href="https://modelcontextprotocol.io">modelcontextprotocol.io</a>.</p>
</article>

Output Markdown:

# Getting Started with MCP

**Source:** Unknown
**Saved:** 2026-06-13T06:12:25.218Z

---

# Getting Started with MCP

The **Model Context Protocol** (MCP) is an open standard for connecting AI assistants to external tools.

## Key Features

-   Standardized tool discovery
-   Structured request/response
-   Multiple transport options (stdio, SSE, streamable HTTP)

## Example

```json
{"method": "tools/call", "params": {"name": "hello"}}

Learn more at modelcontextprotocol.io.

### MCP handshake

→ initialize (protocolVersion: "2024-11-05") ← serverInfo: { name: "html-to-markdown", version: "1.0.0" } → tools/list ← 2 tools: htmltomarkdown, savemarkdown → tools/call htmlto_markdown { html: "<article>..." } ← clean markdown with metadata header

Cold start ~3s (npx). Conversion is instant — Turndown.js runs in-process.