mcpField
H
html-to-markdown-mcp

html-to-markdown-mcp

Local
github.com/MukundaKattaBrowser Automation0Updated 20w ago
Repository

About html-to-markdown-mcp

html-to-markdown-mcp is an MCP server for web-scraping and page-reading agents that converts HTML into consistent Markdown or whitespace-normalized plain text. It uses deterministic conversion and does not detect the main content of a page.

Key features

  1. 01Convert HTML to Markdown
  2. 02Extract normalized plain text
  3. 03Remove scripts and styles by default
  4. 04Use consistent headings, code blocks, and links

Use cases

  1. 01Prepare scraped HTML for Markdown-based processing
  2. 02Return text when formatting is unnecessary
  3. 03Convert HTML without main-content detection

MCP support

It exposes `html_to_md` and `extract_text` tools to MCP clients for converting HTML to Markdown or plain text.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mukundakatta-html-to-markdown": {
      "command": "npx",
      "args": [
        "-y",
        "@mukundakatta/html-to-markdown-mcp"
      ]
    }
  }
}
Run commandnpx -y @mukundakatta/html-to-markdown-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mukundakatta/html-to-markdown-mcp0.1.0

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
htmlstringYes
link_styleenumNoinlined | referenced
heading_styleenumNoatx | setext
strip_scriptsbooleanNo
code_block_styleenumNofenced | indented
bullet_list_markerenumNo- | * | +

Details

From the project README

@mukundakatta/html-to-markdown-mcp

MCP server for HTML → Markdown conversion. For web-scraping and read-the-page agents.

Tools

  • html_to_md(html, ...options) — Turndown-based conversion with sane defaults (ATX headings, fenced code, inline links). Strips scripts/styles by default.
  • extract_text(html) — strip everything, return whitespace-normalized text. Faster than html_to_md when you only need text content.

Why this exists

Web-scraping agents constantly need clean Markdown from HTML. LLMs do this inline but inconsistently across turns (different heading styles, different list markers, sometimes leaving raw HTML tags in). A deterministic converter avoids the variance.

This is intentionally not a full content-extraction pipeline (no Readability-style "main content" detection — use that in a separate step if needed).

Install — Claude Desktop

{
  "mcpServers": {
    "html-to-markdown": { "command": "npx", "args": ["-y", "@mukundakatta/html-to-markdown-mcp"] }
  }
}

Same shape for Cursor / Cline / Windsurf / Zed.

License

MIT OR Apache-2.0.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.