bm-md

from miantiao-me/bm.md

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

466 stars43 forksUpdated Jan 22, 2026
npx skills add https://github.com/miantiao-me/bm.md --skill bm-md

SKILL.md

bm.md Markdown 排版技能

概述

bm.md 是一个专业的 Markdown 排版工具,提供以下核心能力:

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

所有 API 均返回 JSON 格式响应,结果在 result 字段中。


可用工具

1. Markdown 渲染

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

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

请求参数:

参数类型必填默认值说明
markdownstring-Markdown 源文本,支持 GFM 语法、数学公式
markdownStylestringayu-light排版样式 ID,见下方完整列表
codeThemestringkimbie-light代码块高亮主题 ID,见下方完整列表
customCssstring""自定义 CSS,选择器需约束在 #bm-md 下,如 #bm-md h1 { color: red }
enableFootnoteLinksbooleantrue是否将链接转换为脚注形式
openLinksInNewWindowbooleantrue是否在新窗口打开链接
platformstringhtml目标平台:htmlwechatzhihujuejin
footnoteLabelstringFootnotesGFM 脚注区域标题
referenceTitlestringReferences外部链接参考区域标题

curl 示例:

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": "ayu-light",
    "codeTheme": "kimbie-light",
    "platform": "wechat"
  }' \
  -o bm.md.json

响应示例:

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

2. HTML 转 Markdown

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

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

请求参数:

参数类型必填说明
htmlstringHTML 源代码,可以是完整文档或片段

curl 示例:

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

响应示例:

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

3. 提取纯文本

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

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

请求参数:

参数类型必填说明
markdownstringMarkdown 源文本

curl 示例:

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

响应示例:

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

4. Markdown 格式化

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

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

请求参数:

参数类型必填说明
markdownstring待校验的 Markdown 源文本

curl 示例:

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

响应示例:

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

参数参考

排版样式 (markdownStyle)

ID名称风格描述
ayu-lightAyu Light清新淡雅的浅色主题(默认)
bauhausBauhaus包豪斯风格,几何与功能主义
blueprintBlueprint蓝图风格,工程设计感
botanicalBotanical植物园风格,自然柔和
green-simpleGreenSimple绿色简约风格
maximalismMaximalism极繁主义,丰富装饰
neo-brutalismNeo-Brutalism新野兽派,大胆对比
newsprintNewsprint报纸印刷风格
organicOrganic有机自然风格
playful-geometricPlayful Geometric活泼几何图形风格
professionalProfessional专业商务风格
retroRetro复古怀旧风格
sketchSketch手绘素描风格
terminalTerminal终端/命令行风格

代码主题 (codeTheme)

| ID | 名称

...

Read full content

Repository Stats

Stars466
Forks43
LicenseGNU Affero General Public License v3.0