HTML to Markdown
MCP server for converting HTML to Markdown using Turndown.js. Fetch web pages and convert them to clean, formatted Markdown.
What is HTML to Markdown?
HTML to Markdown is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for converting html to markdown using turndown.js. fetch web pages and convert them to clean, formatted markdown.
MCP server for converting HTML to Markdown using Turndown.js. Fetch web pages and convert them to clean, formatted Markdown.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for converting HTML to Markdown using Turndown.js
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx html-to-markdownConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use HTML to Markdown
html-to-markdown-mcp is a Node.js MCP server that fetches any web page by URL and converts its HTML to clean, readable Markdown using the Turndown.js library. It automatically strips scripts, styles, and other noise while preserving headers, links, code blocks, lists, and tables. This makes it ideal for extracting and summarizing web content inside AI coding assistants without manual copy-paste.
Prerequisites
- Node.js 18 or higher (or npx available in PATH)
- An MCP client such as Claude Code, Claude Desktop, or Cursor
- Internet access for fetching URLs (requests to private/internal networks are blocked by default)
Install or run via npx
You can run the server directly with npx without a global install, or install it globally for repeated use.
# No install needed — use npx directly:
npx html-to-markdown-mcp
# Or install globally:
npm install -g html-to-markdown-mcpAdd to Claude Code
Register the server with the Claude CLI for immediate use in any project.
claude mcp add --transport stdio html-to-markdown -- npx html-to-markdown-mcpAdd to Claude Desktop
Edit claude_desktop_config.json to add the server. Use npx so no global install is required.
{
"mcpServers": {
"html-to-markdown": {
"command": "npx",
"args": ["html-to-markdown-mcp"]
}
}
}Fetch and convert a web page
Once configured, ask your AI assistant to fetch a URL. The server exposes a tool that takes a URL, retrieves the HTML, and returns clean Markdown including the page title.
Understand SSRF protection
By default, requests to private/internal IP ranges (localhost, 192.168.x.x, 10.x.x.x, etc.) are blocked to prevent SSRF attacks. To allow local network access, consult the server's ALLOW_LOCAL_NETWORK option.
HTML to Markdown Examples
Client configuration
Minimal Claude Desktop config using npx to run html-to-markdown-mcp without a global install.
{
"mcpServers": {
"html-to-markdown": {
"command": "npx",
"args": ["html-to-markdown-mcp"]
}
}
}Prompts to try
Example prompts that use the fetch-and-convert capability of html-to-markdown-mcp.
- "Fetch https://docs.python.org/3/library/json.html and give me a Markdown summary of the json module."
- "Convert https://github.com/anthropics/anthropic-sdk-python/blob/main/README.md to Markdown and list the installation steps."
- "Fetch the Hacker News front page at https://news.ycombinator.com and give me the top 10 headlines as a Markdown list."
- "Download https://en.wikipedia.org/wiki/Markdown and extract the section on syntax as clean Markdown."Troubleshooting HTML to Markdown
Request blocked with 'SSRF protection' error for internal URLs
The server blocks requests to private network ranges by default. If you need to fetch local services during development, check if the package supports an ALLOW_LOCAL_NETWORK environment variable or run the server with a custom configuration that relaxes this restriction.
Converted Markdown is missing content or looks malformed
Some websites use heavy JavaScript rendering. html-to-markdown-mcp fetches static HTML only (no headless browser), so client-side rendered content may be absent. Try fetching the page's raw HTML endpoint or API instead.
npx command hangs or times out on first run
npx downloads the package on first use. Ensure you have an active internet connection and that npm registry is reachable. You can speed up subsequent runs by installing globally with: npm install -g html-to-markdown-mcp
Frequently Asked Questions about HTML to Markdown
What is HTML to Markdown?
HTML to Markdown is a Model Context Protocol (MCP) server that mcp server for converting html to markdown using turndown.js. fetch web pages and convert them to clean, formatted markdown. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install HTML to Markdown?
Follow the installation instructions on the HTML to Markdown GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with HTML to Markdown?
HTML to Markdown works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is HTML to Markdown free to use?
Yes, HTML to Markdown is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
HTML to Markdown Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to HTML to Markdown? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up HTML to Markdown in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use HTML to Markdown?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.