Agent skill

Bm Md

by miantiao-me in miantiao-me/bm.md

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

LGPL-3.0Auto-check passedMedia & Creative

Install Bm Md

skills CLI
$ npx skills add miantiao-me/bm.md --skill bm-md -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install miantiao-me/bm.md bm-md --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/miantiao-me/bm.md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bm-md .claude/skills/bm-md && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bm-md
GitHub stars
617
Token cost
~2.1k tokens
SKILL.md length
444 words
Files
4 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
LGPL-3.0

At a glance

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

  • Works in 4 steps: Markdown 渲染 → HTML 转 Markdown → 提取纯文本 → …
  • Tasks that involve Diagrams
  • SKILL.md covers 核心能力, 核心工作流, 增强决策与按需参考 and 执行优先级, plus 3 more sections
  • Calls npx, curl and node; reaches bm.md

What it does

Bm Md is an agent skill from miantiao-me/bm.md. 使用 bm.md 写作、改写、排版或渲染 Markdown;生成 Mermaid 与 AntV Infographic,设置图片尺寸、高亮重点,以及执行 HTML/纯文本转换和 Markdown lint

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/infographic.md`, `references/mermaid.md` and `references/rich-markdown.md`).

It sits in Media & Creative, covering Diagrams, Infographics and Markdown. It works with Mermaid, TanStack and Model Context Protocol. The repository describes itself as: 更好用的 Markdown 排版助手|专为微信公众号与多平台排版设计,支持富文本复制、图片生成与矢量 PDF 导出。 The licence is LGPL-3.0.

When your agent uses it

  • Tasks that involve Diagrams
  • Tasks that involve Infographics
  • Tasks that involve Markdown

Example prompts

  • “/bm-md”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Markdown 渲染
  2. HTML 转 Markdown
  3. 提取纯文本
  4. Markdown 格式化

What it can do on your machine

Read from SKILL.md and the folder at commit 824b3b0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • curl
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • bm.md

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bm Md loads about 2.1k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 27 tokens; SKILL.md has 444 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from miantiao-me/bm.md at commit 824b3b0, republished under its LGPL-3.0 licence (© miantiao-me). 444 words, ~2,105 tokens.

Download SKILL.mdSave it as .claude/skills/bm-md/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from 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。
  • 并列、步骤、比较、层级、关系或真实数值:使用 AntV Infographic。字段与模板绑定,按参考中的已验证示例生成。
  • 局部关键结论:使用文本高亮,不要整段高亮。
  • 用户给定尺寸或布局确需固定尺寸:使用图片尺寸语法;不知道尺寸时保留普通图片。

保持克制:不要用图表装饰简单内容,不要用 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

请求参数:

参数类型必填默认值说明
markdownstring是-Markdown 源文本,支持 GFM 语法、数学公式
markdownStylestring否kami排版样式 ID,见下方完整列表
codeThemestring否kimbie-light代码块高亮主题 ID,见下方完整列表
mermaidThemestring否""Mermaid 流程图主题 ID,空字符串表示使用默认主题
infographicThemestring否defaultInfographic 信息图主题 ID
infographicPalettestring否antvInfographic 信息图配色 ID
customCssstring否""自定义 CSS,选择器需约束在 #bm-md 下,如 #bm-md h1 { color: red }
enableFootnoteLinksboolean否true是否将链接转换为脚注形式
breaksboolean否false是否将段落内的软换行转换为 HTML 换行,不影响代码块
openLinksInNewWindowboolean否true是否在新窗口打开链接
platformstring否html目标平台:html、wechat
footnoteLabelstring否FootnotesGFM 脚注区域标题
referenceTitlestring否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

请求参数:

参数类型必填说明
htmlstring是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

请求参数:

参数类型必填说明
markdownstring是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这是一段加粗的文字,包含链接。"
}

Show full SKILL.md (188 more words)Show less
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

请求参数:

参数类型必填说明
markdownstring是待校验的 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名称风格描述
kamiKami简洁的纸张阅读风格(默认)
bauhausBauhaus包豪斯风格,几何与功能主义
blueprintBlueprint蓝图风格,工程设计感
botanicalBotanical植物园风格,自然柔和
newsprintNewsprint报纸印刷风格
retroRetro复古怀旧风格
sketchSketch手绘素描风格
terminalTerminal终端/命令行风格
forest-reviewForest Review森林季报风格,暖调编辑排版
navy-vellumNavy Vellum深蓝羊皮纸风格,静谧的学术手记
rose-nocturneRose Nocturne玫瑰夜曲风格,暗色调时尚编辑
solar-catalogSolar Catalog日光图录风格,展览海报质感
triad-paperTriad Paper三调纸面风格,三色时尚杂志感
field-tabletField Tablet田野铭牌风格,考古手册质感
public-squarePublic Square公共广场风格,行动主义海报
pixel-orbitPixel Orbit像素轨道风格,复古像素街机
代码主题 (codeTheme)
ID名称类型
catppuccin-latteCatppuccin Latte浅色
catppuccin-frappeCatppuccin Frappé深色
catppuccin-macchiatoCatppuccin Macchiato深色
catppuccin-mochaCatppuccin Mocha深色
kimbie-lightKimbie Light浅色
kimbie-darkKimbie Dark深色
panda-syntax-lightPanda Syntax Light浅色
panda-syntax-darkPanda Syntax Dark深色
paraiso-lightParaiso Light浅色
paraiso-darkParaiso Dark深色
rose-pine-dawnRosé Pine Dawn浅色
rose-pineRosé Pine深色
tokyo-night-lightTokyo Night Light浅色
tokyo-night-darkTokyo Night Dark深色
目标平台 (platform)
ID说明
html通用网页,标准 HTML 输出
wechat微信公众号,针对微信编辑器优化

注意事项

  1. 数学公式:支持 $...$(行内)和 $$...$$(块级)语法
  2. GFM 语法:完整支持 GitHub Flavored Markdown,包括表格、任务列表、删除线等
  3. 图片处理:图片 URL 需为可公开访问的地址
  4. 样式内联:输出的 HTML 已将 CSS 内联到元素上,可直接复制使用
  5. 编码要求:请求和响应均使用 UTF-8 编码

© miantiao-me, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/bm-md of miantiao-me/bm.md.

  • SKILL.md
  • references/infographic.md
  • references/mermaid.md
  • references/rich-markdown.md

Open the folder on GitHubat commit 824b3b0

Compare with similar skills

Bm Md next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bm Md compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bm Md this skillmiantiao-me/bm.md617—~2.1kAutomated safety check: PassLGPL-3.0
Us Stock Predictiondigoal/blog8.6k—~1.9kAutomated safety check: WarnGPL-2.0
SVG Technical Infographic Authormodu-ai/moai-adk1.2k—~5.2kAutomated safety check: NotesApache-2.0
Markstream VueSimon-He95/markstream-vue3k—~2.2kAutomated safety check: PassMIT
Show Mefmflurry/settings-opencode171—~1.2kAutomated safety check: PassMIT
Md2wechatgeekjourneyx/md2wechat-skill3.7k—~3.8kAutomated safety check: PassCustom licence

Similar skills

  • 美股个股次日走势预测 skill。当用户输入美股股票代码(如 AAPL、TSLA)或公司名称(如 "苹果"、"特斯拉"),并要求预测次日(T+1)走势、给出交易计划、评估盈亏概率时,触发本 skill。skill 会用 mcpMiniMaxwebsearch 搜证盘前 90…

    8.6k GitHub stars~1.9k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check: warnings
  • Builds hand-editable SVG diagrams from computed layout coordinates, lints the source and renders a 2x PNG, with rules for when mermaid is the better choice.

    1.2k GitHub stars~5.2k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Markstream Vue

    Simon-He95/markstream-vue

    Integrate markstream-vue into a Vue 3 app. An agent skill from Simon-He95/markstream-vue.

    3k GitHub stars~2.2k tokensUpdated today
    Media & CreativeAuto-check passed
  • Show Me

    fmflurry/settings-opencode

    Help the user understand the current topic visually. An agent skill from fmflurry/settings-opencode.

    171 GitHub stars~1.2k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed
  • Md2wechat

    geekjourneyx/md2wechat-skill

    Convert Markdown to WeChat Official Account HTML. An agent skill from geekjourneyx/md2wechat-skill.

    3.7k GitHub stars~3.8k tokensUpdated 17 days ago
    Media & CreativeAuto-check passed
  • Markdown Syntax Guide

    antdigital-ai/agentic-ui

    指导用户使用 @ant-design/agentic-ui 的 Markdown Editor / Renderer 扩展语法。图表场景优先使用内置 chart(HTML 注释 chartType + 表格),只有当内置 chartType 都不能表达诉求时才回退 Mermaid。Triggers on keywords like 表格, 视频, 图表, 卡片, 提示块, 流程图, 语法…

    224 GitHub stars~3.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

Questions about Bm Md

What does Bm Md do?

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

When should I use Bm Md?

Bm Md fits situations like: tasks that involve Diagrams; tasks that involve Infographics; tasks that involve Markdown.

How do I install Bm Md in Claude Code?

Run `npx skills add miantiao-me/bm.md --skill bm-md -a claude-code`. Or copy the skill folder (skills/bm-md in miantiao-me/bm.md) into .claude/skills/bm-md in your project. Claude Code loads it when a task matches its description.

How do I install Bm Md in Codex?

Run `npx skills add miantiao-me/bm.md --skill bm-md -a codex`. Or copy the skill folder (skills/bm-md in miantiao-me/bm.md) into .agents/skills/bm-md in your project. Codex loads it when a task matches its description.

Can I use Bm Md in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add miantiao-me/bm.md --skill bm-md -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bm-md, .gemini/skills/bm-md, .github/skills/bm-md and .opencode/skills/bm-md in your project.

What does Bm Md need to run?

Going by SKILL.md and its folder, Bm Md needs the command-line tools its instructions call (npx, curl and node). Our summary lists: Node.js.

Does Bm Md access the network?

SKILL.md names 1 domain. In commands or code: bm.md; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Bm Md safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bm Md use?

Bm Md is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bm Md use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Bm Md?

Skills that share tags, products or a category with Bm Md: Us Stock Prediction (digoal/blog, 8.6k stars), SVG Technical Infographic Author (modu-ai/moai-adk, 1.2k stars), Markstream Vue (Simon-He95/markstream-vue, 3k stars) and Show Me (fmflurry/settings-opencode, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bm Md?

miantiao-me (a GitHub user) maintains it in miantiao-me/bm.md, which has 617 GitHub stars. The repository was last updated on September 29, 2026.

Source: miantiao-me/bm.md on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.