mcpField
M
markdown

markdown

Local
github.com/rog0xDeveloper Tools1Updated 32w ago
Repository

About markdown

markdown is an MCP server for programmatic Markdown analysis and editing. Its tools cover table-of-contents generation, linting, formatting, statistics, and table creation.

Key features

  1. 01Generate tables of contents
  2. 02Lint common Markdown issues
  3. 03Format headings, spacing, and tables
  4. 04Measure content and structure statistics
  5. 05Create formatted tables from JSON

Use cases

  1. 01Create a navigable contents section
  2. 02Check Markdown before publishing
  3. 03Normalize formatting across documents
  4. 04Turn JSON data into Markdown tables

MCP support

Exposes Markdown generation, linting, formatting, statistics, and table tools to MCP-compatible clients.

Configuration

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

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

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@rog0x/mcp-markdown-tools1.0.2

Tools

5

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
orderedbooleanNoUse ordered (numbered) list instead of unordered
markdownstringYesThe markdown content to generate a table of contents from
maxDepthnumberNoMaximum heading depth to include (1-6)
minDepthnumberNoMinimum heading depth to include (1-6)

Details

From the project README

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.

Tools

generate_toc

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

lint_markdown

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_markdown

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.

markdown_stats

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_table

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

Installation

npm install
npm run build

Usage with Claude Desktop

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"]
    }
  }
}

Usage with Claude Code

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": "node",
      "args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
    }
  }
}

Development

npm install
npm run build
npm start

License

MIT

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.