bm.md Markdown Typesetting Skill

Overview

bm.md is a professional Markdown typesetting tool with the following core capabilities:

Markdown Rendering: Convert Markdown to styled HTML, supporting 14 typesetting styles
HTML to Markdown: Reverse convert HTML content to Markdown format
Plain Text Extraction: Extract plain text from Markdown, removing all format tags
Format Validation & Repair: Automatically detect and fix Markdown format issues

All APIs return responses in JSON format, with results in the

result

field.

Available Tools

1. Markdown Rendering

Render Markdown source text into HTML with inline styles, which can be directly copied to rich text editors.

Endpoint:

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

Request Parameters:

Parameter	Type	Required	Default Value	Description
`markdown`	string	Yes	-	Markdown source text, supporting GFM syntax and mathematical formulas
`markdownStyle`	string	No	`ayu-light`	Typesetting style ID, see the complete list below
`codeTheme`	string	No	`kimbie-light`	Code block highlighting theme ID, see the complete list below
`customCss`	string	No	`""`	Custom CSS, selectors must be constrained under `#bm-md` , e.g., `#bm-md h1 { color: red }`
`enableFootnoteLinks`	boolean	No	`true`	Whether to convert links to footnote form
`openLinksInNewWindow`	boolean	No	`true`	Whether to open links in a new window
`platform`	string	No	`html`	Target platform: `html` , `wechat` , `zhihu` , `juejin`
`footnoteLabel`	string	No	`Footnotes`	GFM footnote section title
`referenceTitle`	string	No	`References`	External link reference section title

curl Example:

bash

curl -X POST https://bm.md/api/markdown/render \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Title\n\nThis is a **bold** text.\n\n```javascript\nconsole.log(\"Hello, World!\");\n```",
    "markdownStyle": "ayu-light",
    "codeTheme": "kimbie-light",
    "platform": "wechat"
  }' \
  -o bm.md.json

Response Example:

json

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

2. HTML to Markdown

Convert HTML source code to Markdown format.

Endpoint:

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

Request Parameters:

Parameter	Type	Required	Description
`html`	string	Yes	HTML source code, which can be a complete document or fragment

curl Example:

bash

curl -X POST https://bm.md/api/markdown/parse \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Title</h1><p>This is a <strong>bold</strong> text.</p>"
  }' \
  -o bm.md.json

Response Example:

json

{
  "result": "# Title\n\nThis is a **bold** text."
}

3. Extract Plain Text

Extract plain text content from Markdown, removing all format tags while preserving paragraph breaks.

Endpoint:

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

Request Parameters:

Parameter	Type	Required	Description
`markdown`	string	Yes	Markdown source text

curl Example:

bash

curl -X POST https://bm.md/api/markdown/extract \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Title\n\nThis is a **bold** text, containing a [link](https://example.com)."
  }' \
  -o bm.md.json

Response Example:

json

{
  "result": "Title\n\nThis is a bold text, containing a link."
}

4. Markdown Formatting

Validate and automatically fix Markdown format issues to unify code style.

Endpoint:

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

Request Parameters:

Parameter	Type	Required	Description
`markdown`	string	Yes	Markdown source text to be validated

curl Example:

bash

curl -X POST https://bm.md/api/markdown/lint \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "#Title\nThis is a text,without proper spacing.\n-List item1\n-List item2"
  }' \
  -o bm.md.json

Response Example:

json

{
  "result": "# Title\n\nThis is a text, without proper spacing.\n\n- List item1\n- List item2"
}

Parameter Reference

Typesetting Styles (markdownStyle)

ID	Name	Style Description
`ayu-light`	Ayu Light	Fresh and elegant light theme (default)
`bauhaus`	Bauhaus	Bauhaus style, geometric and functional
`blueprint`	Blueprint	Blueprint style, engineering design sense
`botanical`	Botanical	Botanical garden style, natural and soft
`green-simple`	GreenSimple	Green minimalist style
`maximalism`	Maximalism	Maximalism, rich decoration
`neo-brutalism`	Neo-Brutalism	Neo-brutalism, bold contrast
`newsprint`	Newsprint	Newsprint style
`organic`	Organic	Organic natural style
`playful-geometric`	Playful Geometric	Playful geometric style
`professional`	Professional	Professional business style
`retro`	Retro	Retro nostalgic style
`sketch`	Sketch	Hand-drawn sketch style
`terminal`	Terminal	Terminal/command line style

Code Themes (codeTheme)

ID	Name	Type
`catppuccin-latte`	Catppuccin Latte	Light
`catppuccin-frappe`	Catppuccin Frappé	Dark
`catppuccin-macchiato`	Catppuccin Macchiato	Dark
`catppuccin-mocha`	Catppuccin Mocha	Dark
`kimbie-light`	Kimbie Light	Light
`kimbie-dark`	Kimbie Dark	Dark
`panda-syntax-light`	Panda Syntax Light	Light
`panda-syntax-dark`	Panda Syntax Dark	Dark
`paraiso-light`	Paraiso Light	Light
`paraiso-dark`	Paraiso Dark	Dark
`rose-pine-dawn`	Rosé Pine Dawn	Light
`rose-pine`	Rosé Pine	Dark
`tokyo-night-light`	Tokyo Night Light	Light
`tokyo-night-dark`	Tokyo Night Dark	Dark

Target Platforms (platform)

ID	Description
`html`	General web pages, standard HTML output
`wechat`	WeChat Official Account, optimized for WeChat editor
`zhihu`	Zhihu Column, adapted to Zhihu typesetting specifications
`juejin`	Juejin, adapted to Juejin editor

Usage Scenarios

Content Creators: One-click conversion of Markdown articles to WeChat Official Account format, directly copy and publish
Cross-platform Publishing: Generate platform-adapted HTML from the same Markdown source file
Content Migration: Convert web content to Markdown for archiving or editing
Text Analysis: Extract plain text for word count, keyword analysis, etc.

Notes

Mathematical Formulas: Supports
```
$...$
```
(inline) and
```
$$...$$
```
(block-level) syntax
GFM Syntax: Fully supports GitHub Flavored Markdown, including tables, task lists, strikethrough, etc.
Image Handling: Image URLs must be publicly accessible
Style Inlining: The output HTML has CSS inlined into elements, which can be directly copied and used
Encoding Requirements: Both requests and responses use UTF-8 encoding

bm-md

NPX Install

Tags

SKILL.md Content (Chinese)

bm.md Markdown Typesetting Skill

Overview

Available Tools

1. Markdown Rendering

2. HTML to Markdown

3. Extract Plain Text

4. Markdown Formatting

Parameter Reference

Typesetting Styles (markdownStyle)

Code Themes (codeTheme)

Target Platforms (platform)

Usage Scenarios

Notes