Markdown 转 HTML 转换器

将 Markdown 文件转换为带有内联 CSS 的精美 HTML，专为微信公众号及其他平台优化。

用户输入工具

当本技能向用户发起提示时，请按以下工具选择规则（优先级从高到低）执行：

1. 优先使用当前 agent 运行时暴露的内置用户输入工具 — 例如 AskUserQuestion、request_user_input、clarify、ask_user 或任何等效工具。
2. 降级方案：若无此类工具，则以带编号的纯文本消息形式输出问题，并请用户针对每个问题回复对应编号/答案。
3. 批量处理：若该工具支持单次调用中提交多个问题，则应将所有适用问题合并为一次调用；若仅支持单问题调用，则须按上述优先级顺序逐个提问。

下方具体出现的 AskUserQuestion 引用仅为示例 — 在其他运行时中请替换为本地等效工具。

脚本目录

Agent 执行上下文：将本 SKILL.md 所在目录确定为 {baseDir}。解析 ${BUN_X} 运行时：若已安装 bun → 使用 bun；若存在 npx → 使用 npx -y bun；否则建议安装 bun。请将 {baseDir} 和 ${BUN_X} 替换为实际值。

偏好设置（EXTEND.md）

按以下优先级顺序查找 EXTEND.md 文件 — 首个匹配项生效：

若均未找到，则使用默认配置。

EXTEND.md 支持配置项包括：默认主题、自定义 CSS 变量、代码块样式。

工作流程

步骤 0：预检（中文内容）

执行条件：仅当输入文件包含中文文本时才执行本步骤。

检测方式：

1. 读取输入的 Markdown 文件
2. 检查内容是否包含 CJK 字符（中/日/韩文）
3. 若不含 CJK 字符 → 直接跳至步骤 1

格式化建议：

若检测到 CJK 内容 且 baoyu-format-markdown 技能可用：

使用 AskUserQuestion 向用户确认是否先执行格式化。格式化可修复以下问题：

• 加粗标记内含标点导致 ** 解析失败
• CJK 与英文混排时的间距异常

若用户同意：调用 baoyu-format-markdown 技能对文件进行格式化，并以格式化后的文件作为后续输入。

若用户拒绝：继续使用原始文件。

步骤 1：确定主题

主题解析顺序（首个匹配项生效）：

1. 用户显式指定主题（通过 CLI --theme 参数或对话）
2. 本技能自身的 EXTEND.md 中定义的 default_theme（已在步骤 0 中检查）
3. baoyu-post-to-wechat 的 EXTEND.md 中定义的 default_theme（跨技能回退）
4. 若以上均未命中 → 使用 AskUserQuestion 向用户确认

跨技能 EXTEND.md 检查（仅当本技能的 EXTEND.md 中未定义 default_theme 时触发）：

若 $HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md 存在，则读取该文件并查找 default_theme: 行。若存在则采用其值；否则继续降级。

若主题由 EXTEND.md 解析得出：直接采用，不得再向用户询问。

若未找到任何默认主题：使用 AskUserQuestion 让用户从下方「主题列表」中确认一个主题。

步骤 1.5：确定引用模式

默认状态：关闭。默认不主动询问用户。

仅当用户明确要求时启用：例如提出“微信外链转底部引用”、“底部引用”、“文末引用”，或传入 --cite 参数。

启用后的行为：

• 普通外部链接将渲染为带编号的上标，并统一归集至文末 引用链接 区域。
• https://mp.weixin.qq.com/... 类链接保持直连形式，不移至文末。
• 链接文字与 URL 完全一致的裸链接（bare links）保留在原文位置。

步骤 2：执行转换

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

步骤 3：报告结果

显示 JSON 输出中的 htmlPath 路径。若生成了备份文件，需一并说明。

使用方法

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

选项说明：