baoyu-markdown-to-html skill: convert Markdown to styled, WeChat-ready HTML

Makes Claude convert a Markdown file into styled HTML with inline CSS, themes and optional bottom citations.

Installs: 32.4K; on skills.sh
Stars: 27.2K; on GitHub
Files: 4; besides SKILL.md
Updated: Nov 2026; last repo commit

baoyu-markdown-to-html runs a bundled script that turns a Markdown file into styled HTML with inline CSS, aimed at WeChat Official Accounts and similar platforms. You pick one of four themes and a color, and it handles code highlighting, tables, footnotes, alerts, math, Mermaid and PlantUML.

The HTML is written next to your Markdown file, and an existing file is backed up first. Mermaid diagrams are rendered through headless Chrome and cached as PNG files. You need bun, or npx to run it.

Good for

Chinese-language writers publishing to WeChat Official Accounts
Bloggers who want clean inline-styled HTML from Markdown
Technical authors with code blocks and Mermaid diagrams

Install baoyu-markdown-to-html

Claude Code

Copy this prompt.

Install the baoyu-markdown-to-html skill in Claude Code. Run this command:

npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-markdown-to-html

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, Mermaid (rendered to PNG via headless Chrome), PlantUML, footnotes, alerts, infographics, and optional bottom citations for external links. Use when user asks for "markdown to html", "convert md to html", "md 转 html", "微信外链转底部引用", or needs styled HTML output from markdown.

Sections in SKILL.md

User Input Tools
Script Directory
Preferences (EXTEND.md)
Workflow
Step 0: Pre-check (Chinese Content)
Step 1: Determine Theme
Step 1.5: Determine Citation Mode
Step 2: Convert
Step 3: Report Result
Usage
Output
Themes
Supported Markdown Features
Frontmatter
Extension Support

Key facts

Author: jimliu (Baoyu)
Repo: jimliu/baoyu-skills
Installs on skills.sh: 32,423 as of Nov 2, 2026
GitHub stars: 27,159 for the whole jimliu/baoyu-skills repo, Nov 2, 2026
License: MIT
Last repo commit: Nov 1, 2026
What is inside: 5 files including SKILL.md: scripts/main.ts, main.test.ts, package.json and bun.lock
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Themes: default, grace, simple, modern; 13 color presets; font and size options
Needs: bun, or npx to run bun; Chrome, Chromium or Edge only for Mermaid diagrams
Output: <name>.html next to the Markdown file; an existing file is backed up first
Script dependencies: baoyu-chrome-cdp and baoyu-md (scripts/package.json)

What it includes

Converts a Markdown file to styled HTML with inline CSS
Run with bun, or npx -y bun if bun is missing. Prints a JSON result with the output path.
Try: “Convert article.md to HTML with the grace theme.”
Runs code · scripts/main.ts
If the file has CJK text it offers to run baoyu-format-markdown first
Only if that skill is installed; it fixes bold-marker and CJK spacing problems.
Pre-check for Chinese text
default, grace, simple or modern; asked once if none is saved
Falls back to a saved EXTEND.md default, then the baoyu-post-to-wechat setting.
Theme choice
Primary color preset or hex, font family and size 14 to 18px
--color, --font-family, --font-size
Moves ordinary external links to numbered bottom citations
Off by default. WeChat links stay direct.
--cite
Override the title, or keep the first heading in the content
--title and --keep-title
Renders mermaid blocks to PNG through headless Chrome and caches them
Falls back to a pre block if Chrome is missing. Options: --mermaid-theme, --mermaid-scale, --mermaid-width, --mermaid-bg, --no-mermaid.
Runs code · Mermaid rendering
Code highlighting, tables, alerts, footnotes, ruby text, math and PlantUML
Markdown features
Writes <name>.html beside the input and renames an old one to .bak-<timestamp>
Write · Output and backup
Default theme, custom CSS variables, code block style, Mermaid defaults
Read from the project, XDG config or home folder.
EXTEND.md preferences

From the official docs

Permissions

Low risk

Claude runs a script that writes HTML and image files next to your Markdown, and it may fetch bun and launch headless Chrome. Check the output folder.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It runs a script and may fetch bun
SKILL.md says to run scripts/main.ts with bun, or npx -y bun if bun is missing. Read the first command before you approve it. github.com
It launches headless Chrome for Mermaid
Mermaid blocks are rendered through headless Chrome and cached as PNG files next to your Markdown. Use --no-mermaid to skip it. github.com
It writes next to your source file
The HTML lands beside the Markdown, and an old HTML file is renamed with a .bak timestamp. Add imgs/.mermaid-cache/ to .gitignore if you do not want the PNGs committed. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md defines no read-only mode. Output goes beside the input file and an existing HTML file is backed up first.
Talks to	npx -y bun downloads bun if it is not installed. The script's dependencies come from npm
Sign-in and keys	SKILL.md names no credentials or sign-in.
Scopes	Claude runs scripts/main.ts with bun on a Markdown file you name It writes an HTML file and, for Mermaid, PNG files in imgs/.mermaid-cache next to your file It may read a baoyu-post-to-wechat preferences file in your home folder

Questions

What does baoyu-markdown-to-html do?

It converts a Markdown file to HTML with inline CSS and WeChat-friendly themes. It handles code highlighting, tables, footnotes, alerts, math, Mermaid diagrams and PlantUML.

How do I install baoyu-markdown-to-html?

Use the install box at the top of this page. You need bun, or npx so Claude can run bun. The README adds that baoyu-post-to-wechat already includes this conversion, so you do not need both for WeChat posts.

Does it need an API key?

No key is named in the skill. Mermaid diagrams need Chrome, Chromium or Edge on the machine; without one the block stays as a pre element and the conversion still succeeds.

Which themes and colors are there?

Four themes: default, grace, simple and modern. There are 13 color presets, including blue, green, red and a warm orange that is the modern theme's default, or you can pass a hex color.

Will it overwrite my HTML file?

It writes next to your Markdown file and renames an existing HTML file to a .bak name with a timestamp first.

Does it work in the Claude app?

SKILL.md documents no way to run its script from the Claude app. It runs bun on your machine and may launch Chrome, so use Claude Code or another terminal agent.

Is baoyu-markdown-to-html safe?

It runs a script that reads your Markdown and writes files beside it. If bun is missing it fetches bun with npx -y bun. Review the first command Claude proposes and check where the output lands.

Information

updated Nov 2, 2026

Repository: jimliu/baoyu-skills
Folder: skills/baoyu-markdown-to-html

jimliu/baoyu-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

baoyu-markdown-to-html SKILL.md · github.com
scripts package.json · github.com
baoyu-skills README · github.com
skills.sh listing · skills.sh