核心用法
baoyu-markdown-to-html 是一款专注于 Markdown 到 HTML 转换的工具技能，输出内联 CSS 的独立 HTML 文件，特别针对微信公众号等平台进行了排版优化。
执行流程：
1. 前置检查：检测中文内容，可选调用 baoyu-format-markdown 修复 CJK 排版问题
2. 主题解析：按优先级（CLI 参数 → 本技能 EXTEND.md → baoyu-post-to-wechat EXTEND.md → 交互询问）确定主题
3. 引用模式：仅当用户明确要求时启用「外链转底部引用」功能，自动区分微信内链与普通外链
4. 转换执行：通过 Bun 运行时调用 TypeScript 主脚本生成 HTML
5. 结果报告：返回 JSON 格式输出路径、备份信息及图片资源映射
主题体系：提供 default（经典）、grace（优雅）、simple（极简）、modern（现代）四种预设主题，支持 13 种配色方案及自定义 CSS 变量。
支持的 Markdown 扩展：代码高亮、Mermaid/PlantUML 图表、数学公式、脚注、警示块（Alerts）、Ruby 注音、标准表格与列表等。
显著优点
- 平台适配深度优化：专门针对微信公众号外链限制设计「底部引用」模式，自动将普通外链转为编号引用并集中呈现，同时保留微信内链的直接可点击性
- 零依赖输出：生成单文件 HTML，CSS 完全内联，无需外部资源即可在任何浏览器或平台预览
- 丰富的可视化支持：原生集成 Mermaid、PlantUML 图表渲染及数学公式支持，满足技术文档需求
- 灵活的主题配置：支持项目级、用户级 EXTEND.md 配置，便于团队统一排版风格
- 智能备份机制：输出冲突时自动创建时间戳备份，避免内容丢失
潜在局限
- 运行时依赖：强制依赖 Bun 运行时（或 fallback 到
npx bun），Node.js 环境需额外安装 - 中文内容特殊处理：非 CJK 内容跳过格式化建议步骤，对纯英文文档的流程完整性略有影响
- EXTEND.md 跨技能耦合：主题回退逻辑依赖
baoyu-post-to-wechat技能的配置文件，存在隐式跨技能依赖 - 引用模式非默认启用：外链转底部引用需显式声明，新用户可能 unaware 此功能存在
适合人群
- 微信公众号运营者与技术作者
- 需要将 Markdown 发布到富媒体平台的博客作者
- 追求一键生成、即拷即贴排版效果的内容创作者
- 技术文档维护者（需图表、代码块、数学公式支持）
常规风险
- 备份文件累积：频繁转换同一文件会产生大量
.bak-时间戳备份，长期运行需注意磁盘清理 - 图片路径处理：输出的
contentImages占位符机制要求后续处理程序正确解析映射关系，否则可能出现图片加载失败 - Bun 运行时兼容性：虽提供
npxfallback，但网络环境不稳定时可能影响首次执行体验 - EXTEND.md 配置漂移：多项目共存时，配置加载优先级复杂，可能出现预期外的主题或样式覆盖