# Markdown

> Markdown is a freemium MCP server for files and documents. Converts Markdown to plain text and pulls out its links and heading outline. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/markdown
- **Repository:** https://github.com/pipeworx-io/mcp-markdown
- **MCP Registry name:** io.github.pipeworx-io/markdown
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a small set of Markdown utilities exposed through the Pipeworx MCP gateway. Its three tools work on Markdown text without any upstream API: one strips formatting down to readable text, one lists every link as text and URL pairs, and one returns the ATX heading outline with levels.

The tools are regex-based and run without a key or network dependency on the tool side, according to the product page. The page also notes that the hosted endpoint is a gateway that additionally lists shared Pipeworx meta-tools alongside these three, and that the npm bridge lists only this pack's tools unless an environment flag is set.

The pack suits developers and agent builders who need to clean up or inspect Markdown inside an AI client workflow. Usage is metered per the gateway's daily call allowance, with an optional API key that raises the cap.

## Features

- **Plain text conversion:** Removes headings, emphasis and code fences, and reduces links and images to their visible text or alt text.
- **Link extraction:** Returns inline Markdown links and bare autolinks as text and URL pairs.
- **Heading outline:** Lists ATX headings from level one to six with their level and text.
- **Keyless operation:** The three tools need no API key, according to the product page and README.
- **Multiple connection options:** Available as a hosted streamable HTTP endpoint or as an npm stdio bridge.

## Good for

- Stripping Markdown formatting from text before passing it to a model or search index
- Collecting every URL referenced in a Markdown document
- Generating a table of contents from a document's ATX headings
- Adding Markdown parsing helpers to an MCP-enabled AI client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http markdown https://gateway.pipeworx.io/markdown/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/markdown/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markdown": {
      "url": "https://gateway.pipeworx.io/markdown/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "markdown": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/markdown/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "markdown": {
      "serverUrl": "https://gateway.pipeworx.io/markdown/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markdown": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/markdown/mcp"
    }
  }
}
```

## Tools

- `markdown_to_text`: Convert Markdown to readable plain text.
- `extract_links`: Extract Markdown links and bare autolinks as text and URL pairs.
- `extract_headings`: Extract the ATX heading outline as level and text entries.

## FAQ

### Does it need an API key?

The tools are described as keyless. An optional Pipeworx API key raises the daily call cap, according to the registry entry and README.

### Which heading style does the outline tool read?

It extracts ATX headings, written with # through ######, as stated in the tool description.

### Can I run it without a network connection?

The product page describes the tools as offline, but the README says the npm bridge forwards calls to the hosted gateway and has no offline mode.

### Is Markdown free?

Markdown has a free plan, with paid plans for more usage or features.

### How do I add Markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http markdown https://gateway.pipeworx.io/markdown/mcp

### What are the best alternatives to Markdown?

The closest alternatives to Markdown are Url, LoveMarkdown, Json, Markdown Logic Express and markitai.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.
- [LoveMarkdown](https://ai-powered.com/mcp/lovemarkdown): LoveMarkdown is an open-source MCP server for files and documents.
- [Json](https://ai-powered.com/mcp/json): Json is a freemium MCP server for developer tools.
- [Markdown Logic Express](https://ai-powered.com/mcp/markdown-logic-express): Markdown Logic Express is a free MCP server for files and documents.
- [markitai](https://ai-powered.com/mcp/markitai): markitai is an open-source MCP server for files and documents.
- [PDF to Markdown](https://ai-powered.com/mcp/pdf-to-markdown-2): PDF to Markdown is a freemium MCP server for files and documents.
- [Markdown to Word](https://ai-powered.com/mcp/markdown-to-word): Markdown to Word is an open-source MCP server for files and documents.
- [Markdown Logic](https://ai-powered.com/mcp/markdown-logic): Markdown Logic is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/markdown-2
