canghe-markdown-to-html
Converts Markdown to styled HTML with WeChat-compatible themes. Supports code highlighting, math, PlantUML, footnotes, alerts, and infographics. Use when user asks for "markdown to html", "convert md to html", "md转html", or needs styled HTML output from markdown.
By freestylefly · 527 installs
npx skills add freestylefly/canghe-skills --skill canghe-markdown-to-html
Source repository · Upstream listing
Markdown to HTML Converter
Converts Markdown files to beautifully styled HTML with inline CSS, optimized for WeChat Official Account and other platforms.
Script Directory
Agent Execution : Determine this SKILL.md directory as SKILL DIR , then use ${SKILL DIR}/scripts/<name .ts .
Script Purpose
scripts/main.ts Main entry point
Preferences (EXTEND.md)
Use Bash to check EXTEND.md existence (priority order):
┌──────────────────────────────────────────────────────────────┬───────────────────┐
│ Path │ Location │
├──────────────────────────────────────────────────────────────┼───────────────────┤
│ .canghe skills/canghe markdown to html/EXTEND.md │ Project directory │
├──────────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.canghe skills/canghe markdown to html/EXTEND.md │ User home │
└──────────────────────────────────────────────────────────────┴───────────────────┘
┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│ Result │ Action │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Found │ Read, parse, apply settings │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Not found │ Use defaults │
└───────────┴───────────────────────────────────────────────────────────────────────────┘
EXTEND.md Supports : Default theme Custom CSS variables Code block style
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. If no CJK content → skip to Step 1
Format Suggestion :
If CJK content detected AND canghe format markdown skill is available:
Use AskUserQuestion to ask whether to format first. Formatting can fix:
Bold markers with punctuation inside causing parse failures
CJK/English spacing issues
If user agrees : Invoke canghe format markdown skill to format the file, then use formatted file as input.
If user declines : Continue with original file.
Step 1: Confirm Theme
Before converting, use AskUserQuestion to confirm the theme (unless user already specified):
Theme Description
default (Recommended) 经典主题 传统排版,标题居中带底边,二级标题白字彩底
grace 优雅主题 文字阴影,圆角卡片,精致引用块
simple 简洁主题 现代极简风,不对称圆角,清爽留白
Step 2: Convert
Step 3: Report Result
Display the output path from JSON result. If backup was created, mention it.
Usage
Options:
Option Description Default
theme <name Theme name (default, grace, simple) default
title <title Override title from frontmatter
keep title Keep the first heading in content false (removed)
help Show help
Examples:
Output
File location : Same directory as input markdown file.
Input: /path/to/article.md
Output: /path/to/article.html
Conflict handling : If HTML file already exists, it will be backed up first:
Backup: /path/to/article.html.bak YYYYMMDDHHMMSS
JSON output to stdout:
Themes
Theme Description
default 经典主题 传统排版,标题居中带底边,二级标题白字彩底
grace 优雅主题 文字阴影,圆角卡片,精致引用块 (by @brzhang)
simple 简洁主题 现代极简风,不对称圆角,清爽留白 (by @okooo5km)
Supported Markdown Features
Feature Syntax
Headings H1 to H6
Bold/Italic bold , italic
Code blocks mermaid diagrams
PlantUML yaml
title: Article Title
author: Author Name
description: Article summary
If no title is found, extracts from first H1/H2 heading or uses filename.
Extension Support
Custom configurations via EXTEND.md. See Preferences section for paths and supported options.