Better Markdown

v1.0.0Developer Toolsstable

更好用的 Markdown 排版助手|一键适配微信公众号、网页与图片。

makrdownmcpskillstanstacktanstack-start
Share:
582
Stars
0
Downloads
0
Weekly
0/5

What is Better Markdown?

Better Markdown is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 更好用的 markdown 排版助手|一键适配微信公众号、网页与图片。

更好用的 Markdown 排版助手|一键适配微信公众号、网页与图片。

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 更好用的 Markdown 排版助手|一键适配微信公众号、网页与图片。

Use Cases

Format Markdown for WeChat public accounts, web, and images automatically.
miantiao-me

Maintainer

LicenseAGPL-3.0
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx bm-md

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Better Markdown

bm.md is a Markdown formatting and typography assistant that transforms plain Markdown into polished content ready for WeChat public accounts, Zhihu, Juejin, web pages, and image exports. It offers 14 typography styles, real-time preview, and multi-platform copy support so writers and developers can produce platform-perfect content without manual reformatting. The MCP integration exposes Markdown rendering, extraction, and linting capabilities to AI assistants, enabling automated document processing pipelines.

Prerequisites

  • Node.js 18+ and pnpm installed
  • An MCP-compatible client such as Claude Desktop or Cursor
  • Git to clone the repository for local development or CLI use
1

Clone and install the repository

Clone the bm.md repository and install dependencies using pnpm. The project uses TanStack Start and Vite 7 as its build foundation.

git clone https://github.com/miantiao-me/bm.md.git
cd bm.md
pnpm install
2

Start the development server

Run the local development server to access the Markdown editor and preview interface at http://localhost:2663.

pnpm dev
3

Use the CLI tool for rendering

The bmmd CLI allows you to render Markdown files to a specific platform format, extract content, or lint and auto-fix typography issues without opening the browser.

pnpm dlx bmmd render article.md --platform wechat --output article.html
cat article.md | pnpm dlx bmmd extract
pnpm dlx bmmd lint article.md --fix
4

Build for production deployment

Build the application for production. The static client assets go to dist/client and the server function to dist/server/server.js.

pnpm run build
5

Configure the MCP client

Add the bm.md MCP server to your Claude Desktop or other MCP client configuration file so AI assistants can invoke its Markdown processing capabilities.

Better Markdown Examples

Client configuration

Add this block to your claude_desktop_config.json to enable bm.md Markdown processing via MCP. The server is invoked using npx with the bmmd package.

{
  "mcpServers": {
    "bm-md": {
      "command": "npx",
      "args": ["bm-md"]
    }
  }
}

Prompts to try

Use these prompts in your MCP-enabled AI assistant after connecting the bm.md server.

- "Format this Markdown article for WeChat public account style with proper typography."
- "Convert my blog post Markdown to Zhihu column format."
- "Lint and fix the typography issues in this Markdown document."
- "Export this Markdown content as an HTML page optimized for web reading."

Troubleshooting Better Markdown

pnpm install fails with workspace errors

Make sure you are using pnpm version 8 or later. Run `npm install -g pnpm` to update, then retry installation from the repository root.

CLI bmmd command not found

Run `pnpm dlx bmmd` instead of a global install, or install globally with `npm install -g bmmd` after the package is published to npm.

Rendered WeChat output looks unstyled

Ensure you specify the correct --platform flag (wechat, zhihu, juejin). WeChat requires inline styles; check that your Markdown does not contain unsupported block elements like raw HTML.

Frequently Asked Questions about Better Markdown

What is Better Markdown?

Better Markdown is a Model Context Protocol (MCP) server that 更好用的 markdown 排版助手|一键适配微信公众号、网页与图片。 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Better Markdown?

Follow the installation instructions on the Better Markdown GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Better Markdown?

Better Markdown works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Better Markdown free to use?

Yes, Better Markdown is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "bm-md": { "command": "npx", "args": ["-y", "bm-md"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Better Markdown?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides