Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

What it does

更好用的 Markdown 排版助手|专为微信公众号与多平台排版设计,支持富文本复制、图片生成与矢量 PDF 导出。

  • Connects Instruction files the AI reads, with steps that call an outside service
  • Account or key Some steps need a key for S3_SECRET_ACCESS_KEY (per the README)
  • Category Docs and writing
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/miantiao-me-bm-md.svg)](https://mcp.popnx.com/en/skills/miantiao-me-bm-md)

Use together with

MCP servers that connect the AI to services for the same work

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by cameroncookeWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 14 months ago

MCP · Connects a serviceRuns on your computer

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by getsentryWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 4 months ago

MCP · Connects a serviceRuns on your computer✓ service owner · xcodebuildmcp.com

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

by HeyPuterWidely used★ 44.2KUpdated 5 months ago

MCP · Connects a serviceRuns in the cloud✓ service owner · puter.com

Similar Skills

Same kind of work, ordered like the Skills list

Compared with similar ones
This one
bm.md
MinerUwatermarks-removerobsidian-skillsanysearch-skill
Makermiantiao-meopendatalabguillaumemeyerkepanoanysearch-ai
Skills11151
GitHub stars62483,91927,72353,1836,905
Last code changeOct 25, 2026Nov 18, 2026Nov 17, 2026Sep 15, 2026Nov 13, 2026
LicenseLGPL-3.0–MITMITApache-2.0

1 skills (instruction sets) by miantiao-me that an AI reads and follows · not an MCP server

How a Skill differs from MCP

MCP = the hands

Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.

Skill = the manual

A text file that teaches the AI how to do a task. It connects to nothing.

Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.

Works with

Not stated by the maker · SKILL.md skills work in apps that support Agent Skills, such as Claude Code, Codex and Cursor

Install

Is it safe?

  • Who made it

    GitHub account miantiao-me (person), 13 years old

  • Use and upkeep

    ★ 624 stars · code last changed Oct 25, 2026

  • Any scripts?

    No, plain text files the AI reads and follows

  • Uses the internet?

    No scripts, so it does not go online by itself

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 6eeece8 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

First: which AI do you use?

Pick your app and this page shows only how to install it there

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill uses the LGPL-3.0 license, which is not on the list we redistribute, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the skills/bm-md folder again. The ZIP must have a bm-md folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick bm-md.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Let Claude Code install it

Copy this sentence and paste it into a Claude Code chat

Where to install

Checking the commands · copy buttons appear once they pass

Checking the commands · copy buttons appear once they pass

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Restart Claude Code, then type /bm-md or ask for a matching task and Claude picks it up

Checked against official docs Nov 12, 2026 · Source: code.claude.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.claude/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    Checking the commands · copy buttons appear once they pass

  3. Restart Claude Code, then type /bm-md or ask for a matching task and Claude picks it up

Skills you install yourself work in the ChatGPT desktop app, Codex CLI and the Codex IDE extension · ChatGPT on the web and mobile cannot use skills you install yourself, only skills that come with a plugin from the directory

ChatGPT desktop app

The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills

Option 1Let ChatGPT install it

Open Codex in the ChatGPT desktop app and paste this sentence into the chat

Where to install

Checking the commands · copy buttons appear once they pass

Checking the commands · copy buttons appear once they pass

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2Put the folder there yourself

Put the bm-md folder at ~/.agents/skills/bm-md

~ is your home folder ($HOME)

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    Checking the commands · copy buttons appear once they pass

After installing

  • ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
  • To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
  • Codex picks up newly installed skills by itself; if one does not show up, restart Codex

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

ChatGPT on the web and mobile

Skills you install yourself do not work here; only skills that come with a plugin from the directory

To use this skill with ChatGPT, use the ChatGPT desktop app as above

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

Option 1Let Codex install it

Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension

Where to install

Checking the commands · copy buttons appear once they pass

Checking the commands · copy buttons appear once they pass

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    Checking the commands · copy buttons appear once they pass

  3. Restart Codex, then ask for a matching task; Codex lists the skill

Option 1Let Cursor install it

Copy this sentence and paste it into a Cursor chat

Where to install

Checking the commands · copy buttons appear once they pass

Checking the commands · copy buttons appear once they pass

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

In Cursor’s Agent chat, type / and pick bm-md

Checked against official docs Nov 12, 2026 · Source: cursor.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.cursor/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    Checking the commands · copy buttons appear once they pass

  3. In Cursor’s Agent chat, type / and pick bm-md

Option 1Let the AI install it

For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat

Where to install

Checking the commands · copy buttons appear once they pass

Checking the commands · copy buttons appear once they pass

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.

View on GitHub ↗

Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026

View the original SKILL.md

The text below comes from the maker’s repo, not from PopNx MCP

Showing the first 8,000 characters · Open the full file on GitHub

---
name: bm-md
description: 使用 bm.md 写作、改写、排版或渲染 Markdown;生成 Mermaid 与 AntV Infographic,设置图片尺寸、高亮重点,以及执行 HTML/纯文本转换和 Markdown lint
---

# bm.md Markdown 排版技能

## 核心能力

使用 bm.md 完成以下任务:

- **Markdown 渲染**:将 Markdown 转换为带样式的 HTML,支持 8 种排版风格、文本高亮与图片尺寸
- **HTML 转 Markdown**:将 HTML 内容逆向转换为 Markdown 格式
- **纯文本提取**:从 Markdown 中提取纯文本,移除所有格式标记
- **格式校验与修复**:自动检测并修复 Markdown 格式问题

## 核心工作流

1. **明确交付目标**:确认受众、输出平台、事实边界与期望文件;信息不足时先询问,不猜测事实或数值。
2. **先组织正文**:先完成标题层级、段落、列表、表格、引用和代码,再考虑视觉增强。
3. **按语义选择增强**:只在增强理解时加入 Mermaid、Infographic、高亮或图片尺寸。遵循下方决策规则并按需读取对应参考。
4. **执行渲染**:优先使用 CLI;本地无法执行命令或用户明确要求远程调用时,改用 REST API。
5. **检查并回退**:检查命令状态、响应的 `result`、图表错误和关键信息完整性。增强语法失败时先修正;仍失败则回退为结构清晰的正文、列表或表格,不交付损坏的图表。

## 增强决策与按需参考

- 流程、调用链、状态、类关系或 ER 模型:使用 [Mermaid](references/mermaid.md)。
- 并列、步骤、比较、层级、关系或真实数值:使用 [AntV Infographic](references/infographic.md)。字段与模板绑定,按参考中的已验证示例生成。
- 局部关键结论:使用[文本高亮](references/rich-markdown.md),不要整段高亮。
- 用户给定尺寸或布局确需固定尺寸:使用[图片尺寸语法](references/rich-markdown.md);不知道尺寸时保留普通图片。

保持克制:不要用图表装饰简单内容,不要用 Mermaid 和 Infographic 重复表达同一信息,不要虚构事实或数值。生成丰富 Markdown 后,必须通过 bm.md 渲染并检查结果。

## 执行优先级

1. **优先使用 CLI**:如果本地可执行 `node --version`,使用 `bmmd` 命令处理 Markdown。
2. **CLI 调用方式**:如果系统已安装 `bmmd`,直接使用;否则使用 `npx -y bmmd` 临时运行。
3. **兜底使用 REST API**:如果没有 Node.js 环境、无法执行本地命令,或用户明确要求远程调用,再使用 `https://bm.md/api/markdown/*`。

CLI 默认将结果输出到 stdout,可通过 `--output <file>` 写入文件。REST API 返回 JSON,结果在 `result` 字段中。

---

## 可用工具

### 1. Markdown 渲染

将 Markdown 源文本渲染为带内联样式的 HTML,可直接复制到富文本编辑器。

**CLI 示例(优先)**:

```bash
npx -y bmmd render article.md --platform wechat --output article.html
```

支持 stdin:

```bash
cat article.md | npx -y bmmd render --platform wechat > article.html
```

**端点**: `POST https://bm.md/api/markdown/render`

**请求参数**:

| 参数                   | 类型    | 必填 | 默认值         | 说明                                                                  |
| ---------------------- | ------- | ---- | -------------- | --------------------------------------------------------------------- |
| `markdown`             | string  | 是   | -              | Markdown 源文本,支持 GFM 语法、数学公式                              |
| `markdownStyle`        | string  | 否   | `kami`         | 排版样式 ID,见下方完整列表                                           |
| `codeTheme`            | string  | 否   | `kimbie-light` | 代码块高亮主题 ID,见下方完整列表                                     |
| `mermaidTheme`         | string  | 否   | `""`           | Mermaid 图表主题 ID,可选空字符串 `""`(默认浅色)或 `"dark"`(深色) |
| `infographicTheme`     | string  | 否   | `default`      | Infographic 信息图主题 ID                                             |
| `infographicPalette`   | string  | 否   | `antv`         | Infographic 信息图配色 ID                                             |
| `customCss`            | string  | 否   | `""`           | 自定义 CSS,选择器需约束在 `#bm-md` 下,如 `#bm-md h1 { color: red }` |
| `enableFootnoteLinks`  | boolean | 否   | `true`         | 是否将链接转换为脚注形式                                              |
| `breaks`               | boolean | 否   | `false`        | 是否将段落内的软换行转换为 HTML 换行,不影响代码块                    |
| `openLinksInNewWindow` | boolean | 否   | `true`         | 是否在新窗口打开链接                                                  |
| `platform`             | string  | 否   | `html`         | 目标平台:`html`、`wechat`                                            |
| `footnoteLabel`        | string  | 否   | `Footnotes`    | GFM 脚注区域标题                                                      |
| `referenceTitle`       | string  | 否   | `References`   | 外部链接参考区域标题                                                  |

**curl 示例**:

````bash
curl -X POST https://bm.md/api/markdown/render \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# 标题\n\n这是一段**加粗**的文字。\n\n```javascript\nconsole.log(\"Hello, World!\");\n```",
    "markdownStyle": "kami",
    "codeTheme": "kimbie-light",
    "platform": "wechat"
  }' \
  -o bm.md.json
````

**响应示例**:

```json
{
  "result": "<div id=\"bm-md\"><h1 style=\"...\">标题</h1>...</div>"
}
```

---

### 2. HTML 转 Markdown

将 HTML 源代码转换为 Markdown 格式。

**CLI 示例(优先)**:

```bash
npx -y bmmd parse page.html --output article.md
```

支持 stdin:

```bash
cat page.html | npx -y bmmd parse > article.md
```

**端点**: `POST https://bm.md/api/markdown/parse`

**请求参数**:

| 参数   | 类型   | 必填 | 说明                              |
| ------ | ------ | ---- | --------------------------------- |
| `html` | string | 是   | HTML 源代码,可以是完整文档或片段 |

**curl 示例**:

```bash
curl -X POST https://bm.md/api/markdown/parse \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>标题</h1><p>这是一段<strong>加粗</strong>的文字。</p>"
  }' \
  -o bm.md.json
```

**响应示例**:

```json
{
  "result": "# 标题\n\n这是一段**加粗**的文字。"
}
```

---

### 3. 提取纯文本

从 Markdown 中提取纯文本内容,移除所有格式标记,保留段落分隔。

**CLI 示例(优先)**:

```bash
npx -y bmmd extract article.md --output article.txt
```

**端点**: `POST https://bm.md/api/markdown/extract`

**请求参数**:

| 参数       | 类型   | 必填 | 说明            |
| ---------- | ------ | ---- | --------------- |
| `markdown` | string | 是   | Markdown 源文本 |

**curl 示例**:

```bash
curl -X POST https://bm.md/api/markdown/extract \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# 标题\n\n这是一段**加粗**的文字,包含[链接](https://example.com)。"
  }' \
  -o bm.md.json
```

**响应示例**:

```json
{
  "result": "标题\n\n这是一段加粗的文字,包含链接。"
}
```

---

### 4. Markdown 格式化

校验并自动修复 Markdown 格式问题,统一代码风格。

**CLI 示例(优先)**:

```bash
# 输出修复后的 Markdown
npx -y bmmd lint article.md --output article.fixed.md

# 直接写回源文件
npx -y bmmd lint article.md --fix
```

**端点**: `POST https://bm.md/api/markdown/lint`

**请求参数**:

| 参数       | 类型   | 必填 | 说明                     |
| ---------- | ------ | ---- | ------------------------ |
| `markdown` | string | 是   | 待校验的 Markdown 源文本 |

**curl 示例**:

```bash
curl -X POST https://bm.md/api/markdown/lint \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "#标题\n这是一段文字,没有正确的空格。\n-列表项1\n-列表项2"
  }' \
  -o bm.md.json
```

**响应示例**:

```json
{
  "result": "# 标题\n\n这是一段文字,没有正确的空格。\n\n- 列表项1\n- 列表项2"
}
```

---

## 参数参考

### 排版样式 (markdownStyle)

| ID              | 名称          | 风格描述                                   |
| --------------- | ------------- | ------------------------------------------ |
| `kami`          | Kami          | 羊皮纸长文排版,适合报告与长篇阅读(默认) |
| `bauhaus`       | Bauhaus       | 几何色块讲义,适合设计讲义与产品宣言       |
| `blueprint`     | Blueprint     | 冷静的技术规格书,适合 API 文档与工程手册  |
| `botanical`     | Botanical     | 留白舒展的宋体散文,适合随笔与读书笔记     |
| `newsprint`     | Newsprint     | 粗衬线报纸特稿,适合新闻评论与深度报道     |
| `retro`         | Retro         | 暖色老派平装书,适合小说与回忆录           |
| `sketch`        | Sketch        | 波浪线草稿本,适合课堂笔记与思路草稿       |
| `terminal`      | Terminal      | 低眩光深色终端,适合 CLI 文档与运维手册    |
| `forest-review` | Forest Review | 黑体标题配宋体正文,适合书评与文化专栏     |
| `navy-vellum`   | Navy Vellum   | 藏蓝深色全宋体,适合论文笔记与夜间长读     |
| `rose-nocturne` | Rose Nocturne | 紫黑底配宋体大标题,适合艺术评论与品牌故事 |
| `solar-catalog` | Solar Catalog | 大标题展签式图录,适合作品集与展览介绍     |
| `triad-paper`   | Triad Paper   | Riso 三色套印,适合独立刊物与活动手册      |
| `field-tablet`  | Field Tablet  | 紧凑的档案卡笔记,适合调研记录与考察报告   |
| `public-square` | Public Square | 大字粗黑告示,适合公告与倡议书             |
| `pixel-orbit`   | Pixel Orbit   | 深色像素边框,适合游戏攻略与开发日志       |

### 代码主题 (codeTheme)

| ID                     | 名称                 | 类型 |
| ---------------------- | -------------------- | ---- |
| `catppuccin-latte`     | Catppuccin Latte     | 浅色 |
| `catppuccin-frappe`    | Catppuccin Frappé    | 深色 |
| `catppuccin-macchiato` | Catppuccin Macchiato | 深色 |
| `catppuccin-mocha`     | Catppuccin Mocha     | 深色 |
| `kimbie-light`         | Kimbie Light         | 浅色 |
| `kimbie-dark`          | Kimbie Dark          | 深色 |
| `panda-syntax-light`   | Panda Syntax Light   | 浅色 |
| `panda-syntax-dark`    | Panda Syntax Dark    | 深色 |
| `paraiso-light`        | Paraiso Light        | 浅色 |
| `paraiso-dark`         | Paraiso Dark         | 深色 |
| `rose-pine-dawn`       | Rosé Pine Dawn       | 浅色 |
| `rose-pine`            | Rosé Pine            |

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

From GitHub

GitHub stars
624
Maker
miantiao-me
License
LGPL-3.0
Last code change
Oct 25, 2026
SKILL.md files in the repo (including translated copies and templates)
1
Topics
makrdown, mcp, skills, tanstack, tanstack-start