tuzi-markdown-to-html

仓库: tuziapi/tuzi-skills
安装量: 42
排名: #17341

安装

npx skills add https://github.com/tuziapi/tuzi-skills --skill tuzi-markdown-to-html
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/.ts . Script Purpose scripts/main.ts Main entry point Preferences (EXTEND.md) Use Bash to check EXTEND.md existence (priority order):

Check project-level first

test -f .tuzi-skills/tuzi-markdown-to-html/EXTEND.md && echo "project"

Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)

test
-f
"
$HOME
/.tuzi-skills/tuzi-markdown-to-html/EXTEND.md"
&&
echo
"user"
┌──────────────────────────────────────────────────────────────┬───────────────────┐
│ Path │ Location │
├──────────────────────────────────────────────────────────────┼───────────────────┤
│ .tuzi-skills/tuzi-markdown-to-html/EXTEND.md │ Project directory │
├──────────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.tuzi-skills/tuzi-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
:
Read input markdown file
Check if content contains CJK characters (Chinese/Japanese/Korean)
If no CJK content → skip to Step 1
Format Suggestion
:
If CJK content detected AND
tuzi-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
tuzi-format-markdown
skill to format the file, then use formatted file as input.
If user declines
Continue with original file. Step 1: Determine Theme Theme resolution order (first match wins): User explicitly specified theme (CLI --theme or conversation) EXTEND.md default_theme (this skill's own EXTEND.md, checked in Step 0) tuzi-post-to-wechat EXTEND.md default_theme (cross-skill fallback) If none found → use AskUserQuestion to confirm Cross-skill EXTEND.md check (only if this skill's EXTEND.md has no default_theme ):

Check tuzi-post-to-wechat EXTEND.md for default_theme

test
-f
"
$HOME
/.tuzi-skills/tuzi-post-to-wechat/EXTEND.md"
&&
grep
-o
'default_theme:.*'
"
$HOME
/.tuzi-skills/tuzi-post-to-wechat/EXTEND.md"
If theme is resolved from EXTEND.md
Use it directly, do NOT ask the user.
If no default found
Use AskUserQuestion to confirm: Theme Description default (Recommended) 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 grace 优雅主题 - 文字阴影，圆角卡片，精致引用块 simple 简洁主题 - 现代极简风，不对称圆角，清爽留白 modern 现代主题 - 大圆角、药丸形标题、宽松行距（搭配 --color red 还原传统红金风格） Step 2: Convert npx -y bun ${SKILL_DIR} /scripts/main.ts < markdown_file

--theme < theme

Step 3: Report Result Display the output path from JSON result. If backup was created, mention it. Usage npx -y bun ${SKILL_DIR} /scripts/main.ts < markdown_file

[ options ] Options: Option Description Default --theme Theme name (default, grace, simple, modern) default --color Primary color: preset name or hex value theme default --font-family Font: sans, serif, serif-cjk, mono, or CSS value theme default --font-size Font size: 14px, 15px, 16px, 17px, 18px 16px --title <title> Override title from frontmatter --keep-title Keep the first heading in content false (removed) --help Show help Color Presets: Name Hex Label blue

0F4C81

经典蓝 green

009874

翡翠绿 vermilion

FA5151

活力橘 yellow

FECE00

柠檬黄 purple

92617E

薰衣紫 sky

55C9EA

天空蓝 rose

B76E79

玫瑰金 olive

556B2F

橄榄绿 black

333333

石墨黑 gray

A9A9A9

雾烟灰 pink

FFB7C5

樱花粉 red

A93226

中国红 orange

D97757

暖橘 (modern default) Examples:

Basic conversion (uses default theme, removes first heading)

npx -y bun ${SKILL_DIR} /scripts/main.ts article.md

With specific theme

npx -y bun ${SKILL_DIR} /scripts/main.ts article.md --theme grace

Theme with custom color

npx -y bun ${SKILL_DIR} /scripts/main.ts article.md --theme modern --color red

Keep the first heading in content

npx -y bun ${SKILL_DIR} /scripts/main.ts article.md --keep-title

Override title

npx
-y
bun
${SKILL_DIR}
/scripts/main.ts article.md
--title
"My Article"
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: { "title" : "Article Title" , "author" : "Author Name" , "summary" : "Article summary..." , "htmlPath" : "/path/to/article.html" , "backupPath" : "/path/to/article.html.bak-20260128180000" , "contentImages" : [ { "placeholder" : "MDTOHTMLIMGPH_1" , "localPath" : "/path/to/img.png" , "originalPath" : "imgs/image.png" } ] } Themes Theme Description default 经典主题 - 传统排版，标题居中带底边，二级标题白字彩底 grace 优雅主题 - 文字阴影，圆角卡片，精致引用块 (by @brzhang) simple 简洁主题 - 现代极简风，不对称圆角，清爽留白 (by @okooo5km) modern 现代主题 - 大圆角、药丸形标题、宽松行距（搭配 --color red 还原传统红金风格） Supported Markdown Features Feature Syntax Headings

H1

to

H6

Bold/Italic bold , italic Code blocks ``lang with syntax highlighting Inline codecode` Tables GitHub-flavored markdown tables Images alt Links text with footnote references Blockquotes

quote Lists - unordered, 1. ordered Alerts [!NOTE] , [!WARNING] , etc. Footnotes [^1] references Ruby text `{base Mermaid mermaid diagrams PlantUMLplantuml diagrams Frontmatter Supports YAML frontmatter for metadata:

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.

← 返回排行榜