Markdown

io.github.rog0x由 GitHub 帳號 rog0x 發布v1.0.2更新於 Oct 24, 2026

Markdown TOC, lint, format, stats for AI agents

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

讓助理分析、檢查、格式化並產生 Markdown 內容，包括目錄與表格。

可以做什麼
提供五個 Markdown 工具：generate_toc 依標題產生目錄，可設定標題深度與有序或無序清單；lint_markdown 檢查常見問題，例如連結語法錯誤、標題層級違規、行尾空白、圖片缺少替代文字、清單標記不一致與過多空行；format_markdown 美化內容，正規化標題樣式、修正間距、對齊表格欄位並依可設定寬度換行；markdown_stats 統計字數、字元數、預估閱讀時間、各層級標題、連結、圖片、程式碼區塊與語言分布、清單項目、引用與段落數；generate_table 從 JSON 資料產生格式化表格，支援欄位選擇、自訂表頭與欄位對齊。
適用情境
適合助理處理 Markdown 文件時使用，例如檢查一致性、整理格式、產生目錄、彙整文件結構，或把 JSON 資料轉成 Markdown 表格。
執行需求
透過 npm 套件 @rog0x/mcp-markdown-tools 以 stdio 方式在本機執行，需要 Node.js。README 說明從原始碼安裝與建置，並在用戶端設定中註冊建置後的進入點。未宣告任何驗證、環境變數或標頭。
安裝前請注意
這些工具處理傳入的 Markdown 內容；format_markdown 會改寫內容，覆蓋原始檔案前應先檢查輸出。未顯示需要憑證、付款或向第三方傳送資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Markdown，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 387a1c6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分