Markdown

io.github.rog0xPublished by GitHub account rog0xv1.0.2Updated Oct 24, 2026

Markdown TOC, lint, format, stats for AI agents

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated overview

Lets an assistant analyze, lint, format, and generate Markdown content, including tables of contents and tables.

What you can do
Provides five Markdown tools: generate_toc builds a table of contents from headings with configurable depth and list style; lint_markdown flags issues such as broken link syntax, heading hierarchy problems, trailing whitespace, missing image alt text, inconsistent list markers, and excessive blank lines; format_markdown prettifies content by normalizing heading styles, fixing spacing, aligning table columns, and wrapping long lines; markdown_stats reports word and character counts, reading time, headings, links, images, code blocks, lists, blockquotes, and paragraphs; generate_table builds formatted tables from JSON data with column selection, custom headers, and alignment.
When to use it
Useful when an assistant works with Markdown documents and needs to check consistency, clean up formatting, produce a table of contents, summarize document structure, or turn JSON data into a Markdown table.
Requirements
Runs locally as a stdio process via the npm package @rog0x/mcp-markdown-tools, so Node.js is needed. The README shows installing and building from source and registering the built entry point in a client configuration. No authentication, environment variables, or headers are declared.
Before you install
The tools operate on Markdown content passed to them; format_markdown rewrites content, so review its output before saving over an original file. No credentials, payments, or third-party data transfers are indicated.

Installation

In SourceWeft

  1. Open Markdown in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npm installnpm 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
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:

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

Or add it to your .mcp.json configuration:

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

Development

bash
npm installnpm run buildnpm start

License

MIT

Source: README.md at commit 387a1c6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts