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.