用途：将冗长的 Markdown 文档转换为单个自包含 HTML 文件，用图表代替段落、步骤卡片代替编号列表、提示框突出关键内容，方便快速扫读。
主要能力：内置 template.html（含 CSS、Mermaid CDN、主题切换、目录侧栏、页脚）与 components.md（步骤卡片、提示框、Mermaid 块、优缺点、对比卡片、折叠块等组件目录），并提供 examples/ 参考样例。输出为自包含页面，除模板中已有的 CDN 脚本外不引用外部文件。
使用方式：命令为 /md2html <file.md>（输出同目录 <file>.html）、/md2html <file.md> --out X.html（自定义路径）、/md2html（无参数时询问文件）。执行时先解析输入、读取模板与组件目录及一个样例，再分析源文档（语言、标题、副标题、文档类型、阅读时长、章节映射），然后一次性构建并写出 HTML，最后做校验。
适用场景：计划、规格、系统设计、RFC、运行手册、复盘、头脑风暴、笔记等长文档的可读化呈现。
限制：模板仅支持 LTR，RTL 语言存在已知视觉限制；Mermaid 依赖 CDN，在打开 HTML 时解析；不修改 template.html 与 components.md；技术内容、代码、文件名、命令保持原样；图标仅用 SVG，不使用 emoji。跨 AI 兼容 Claude Code、Codex CLI、Antigravity。