HTML to Markdown

Converts HTML to Markdown by fetching pages or processing HTML content, preserving formatting and metadata.

javascript

4

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "levz0r-html-to-markdown-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/html-to-markdown-mcp/index.js"
      ]
    }
  }
}

This MCP server converts HTML into Markdown by leveraging Turndown.js, enabling you to fetch web content and produce clean, well-formatted Markdown documents quickly. It automates stripping unwanted elements, preserves structure like headings, links, code blocks, and tables, and can extract metadata from pages for easy use in downstream workflows.

How to use

You connect this server to your MCP client to convert HTML to Markdown on demand. Use it when you want to turn a webpage or raw HTML into Markdown for documentation, notes, or content pipelines. The server supports fetching HTML from a URL or converting supplied HTML, while preserving formatting and removing unnecessary page elements.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install the MCP server globally so you can run it from anywhere.

npm install -g html-to-markdown-mcp

Alternatively, use the server without installation via npx.

npx html-to-markdown-mcp

Usage notes and configuration

To use this MCP server with your client, you can run it as a local process and connect via standard MCP channels. The server can be started through different commands depending on how you prefer to run it, such as Node.js directly or via npx.

If you are integrating with Claude, Cursor, or Codex, you can configure a local MCP server by pointing the client to a stdio-based command that launches the server process.

Notes for local development and variants

Common runtime commands shown for local development include the following variants. Use the one that matches your setup.

# Run using a local Node.js path to the server index
node /absolute/path/to/html-to-markdown-mcp/index.js

npx html-to-markdown-mcp

npx -y html-to-markdown-mcp

Available tools

html_to_markdown

Fetch HTML from a URL or convert provided HTML content to Markdown format. Includes options to include metadata, limit output length, and save full Markdown to a file.