baoyu-markdown-to-html

Agent Execution: Determine this SKILL.md directory as SKILL_DIR, then use ${SKILL_DIR}/scripts/.ts.

| Script | Purpose |

|--------|---------|

| scripts/main.ts | Main entry point |

Use Bash to check EXTEND.md existence (priority order):

```bash

# Check project-level first

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

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

test -f "$HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md" && echo "user"

```

┌──────────────────────────────────────────────────────────────┬───────────────────┐

│ Path │ Location │

├──────────────────────────────────────────────────────────────┼───────────────────┤

│ .baoyu-skills/baoyu-markdown-to-html/EXTEND.md │ Project directory │

├──────────────────────────────────────────────────────────────┼───────────────────┤

│ $HOME/.baoyu-skills/baoyu-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

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 baoyu-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 baoyu-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

```bash

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

```

Step 3: Report Result

Display the output path from JSON result. If backup was created, mention it.

```bash

npx -y bun ${SKILL_DIR}/scripts/main.ts [options]

```

Options:

| Option | Description | Default |

|--------|-------------|---------|

| --theme | Theme name (default, grace, simple) | default |

| --title