bm.md Markdown 排版技能

概述

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

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

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

可用工具

1. Markdown 渲染

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

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

请求参数:

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"
  }'

响应示例:

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

2. HTML 转 Markdown

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

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

请求参数:

curl 示例:

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

响应示例:

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

3. 提取纯文本

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

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

请求参数:

curl 示例:

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

响应示例:

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

4. Markdown 格式化

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

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

请求参数:

curl 示例:

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

响应示例:

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

参数参考

排版样式 (markdownStyle)

代码主题 (codeTheme)

目标平台 (platform)

使用场景

1. 内容创作者：将 Markdown 文章一键转换为微信公众号格式，直接粘贴发布
2. 跨平台发布：同一份 Markdown 源文件，生成适配不同平台的 HTML
3. 内容迁移：将网页内容转换为 Markdown 进行存档或编辑
4. 文本分析：提取纯文本用于字数统计、关键词分析等

注意事项

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