mcp-markdown-tools

An MCP (Model Context Protocol) server that provides tools for working with Markdown content. Analyze, lint, format, and generate Markdown programmatically through any MCP-compatible client.

Generate a table of contents from markdown headings. Configure minimum/maximum heading depth and choose between ordered or unordered list output.

Check markdown for common issues including broken link syntax, heading hierarchy violations, trailing whitespace, missing image alt text, inconsistent list markers, and excessive blank lines.

Format and prettify markdown content. Normalizes heading styles (converts setext to ATX), fixes spacing around headings and blocks, aligns table columns, and wraps long lines at configurable width.

Compute detailed statistics from markdown content: word count, character count, estimated reading time, headings by level, link count, image count, code block count with language distribution, list items, blockquotes, and paragraph count.

Generate formatted markdown tables from JSON data. Supports column selection, custom header labels, and per-column alignment (left, center, right).

npm install
npm run build

Add the following to your Claude Desktop configuration file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markdown-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

Add the server using the Claude Code CLI:

claude mcp add markdown-tools node D:/products/mcp-servers/mcp-markdown-tools/dist/index.js

Or add it to your .mcp.json configuration:

{
  "mcpServers": {
    "markdown-tools": {
      "command": "n