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

   ,

   request_user_input

   ,

   clarify

   ,

   ask_user

   , 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

Script Directory

Agent Execution: Determine this SKILL.md directory as

{baseDir}

${BUN_X}

bun

bun

npx

npx -y bun

{baseDir}

${BUN_X}

scripts/main.ts

Preferences (EXTEND.md)

Check EXTEND.md in priority order — the first one found wins:

.baoyu-skills/baoyu-markdown-to-html/EXTEND.md

${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-markdown-to-html/EXTEND.md

$HOME/.baoyu-skills/baoyu-markdown-to-html/EXTEND.md

If none 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

baoyu-format-markdown

Use

AskUserQuestion

• Bold markers with punctuation inside causing

  **

  parse failures
• CJK/English spacing issues

If user agrees: Invoke

baoyu-format-markdown

If user declines: Continue with original file.

Step 1: Determine Theme

Theme resolution order (first match wins):

1. User explicitly specified theme (CLI

   --theme

   or conversation)
2. EXTEND.md

   default_theme

   (this skill's own EXTEND.md, checked in Step 0)

3. baoyu-post-to-wechat

   EXTEND.md

   default_theme

   (cross-skill fallback)
4. If none found → use AskUserQuestion to confirm

Cross-skill EXTEND.md check (only if this skill's EXTEND.md has no

default_theme

Read

$HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md

default_theme:

If theme is resolved from EXTEND.md: Use it directly, do NOT ask the user.

If no default found: use

AskUserQuestion

Step 1.5: Determine Citation Mode

Default: Off. Do not ask by default.

Enable only if the user explicitly asks for "微信外链转底部引用", "底部引用", "文末引用", or passes

--cite

Behavior when enabled:

• Ordinary external links are rendered with numbered superscripts and collected under a final

  引用链接

  section.

• https://mp.weixin.qq.com/...

  links stay as direct links and are not moved to the bottom.
• Bare links where link text equals URL stay inline.

Step 2: Convert

${BUN_X} {baseDir}/scripts/main.ts <markdown_file> --theme <theme> [--cite]

Step 3: Report Result

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

Usage

${BUN_X} {baseDir}/scripts/main.ts <markdown_file> [options]

Options:

--theme <name>

--color <name|hex>

--font-family <name>

--font-size <N>

--title <title>

--cite

引用链接

--keep-title

--help

Color Presets:

Examples:

# Basic conversion (uses default theme, removes first heading)
${BUN_X} {baseDir}/scripts/main.ts article.md

# With specific theme
${BUN_X} {baseDir}/scripts/main.ts article.md --theme grace

# Theme with custom color
${BUN_X} {baseDir}/scripts/main.ts article.md --theme modern --color red

# Enable bottom citations for ordinary external links
${BUN_X} {baseDir}/scripts/main.ts article.md --cite

# Keep the first heading in content
${BUN_X} {baseDir}/scripts/main.ts article.md --keep-title

# Override title
${BUN_X} {baseDir}/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

default

grace

simple

modern

--color red

Supported Markdown Features

# H1

###### H6

**bold**

*italic*

```lang

`code`

![alt](src)

[text](url)

--cite

> quote

-

1.

> [!NOTE]

> [!WARNING]

[^1]

```mermaid

```plantuml

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.