Agent skill · creative production · jimliu
baoyu-markdown-to-html
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.
Why this skill is useful
Adds specific commands for converting Markdown to styled HTML with WeChat-compatible themes, which the AI wouldn't reliably generate on its own.
What it needs
Requires bun, npx installed locally. About 6k tokens when loaded. Last updated 2026-07-04. 24,677 stars on the source repository.
What this skill does
Markdown to HTML Converter Converts Markdown files to beautifully styled HTML with inline CSS, optimized for WeChat Official Account and other platforms. User Input Tools When this skill prompts the user, follow this tool-selection rule (priority order): 1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, requestuserinput, clarify, askuser, or any equivalent. 2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question. 3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order. Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes. Script Directory Agent Execution: Determine this SKILL.md directory as {baseDir}. Resolve ${BUNX} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUNX} with actual values. Script Purpose -------- --------- scripts/main.ts Main entry point Preferences (EXTEND.md) Check EXTEND.md in priority order — the first one found wins: Priority Path Scope ---------- ------ ------- 1 .baoyu-skills/baoyu-markdown-to-html/EXTEND.md Project 2 ${XDGCONFIGHOME:-$HOME/.config}/baoyu-skills/baoyu-markdown-to-html/EXTEND.md XDG 3 $HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md User home If none found, use defaults. EXTEND.md supports: default theme, custom CSS variables, code block style, mermaid defaults (mermaidtheme, mermaidscale, mermaidbackground). Workflow Step 0: Pre-check (Chinese Content) Condition: Only execute if input file contains Chinese text. Detection: 1. Read input markdown file 2. Check if content contains CJK characters (Chinese/Japanese/Korean) 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jimliu/baoyu-markdown-to-html