md2html
将长篇Markdown文档转换为美观、自包含的HTML页面
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：md2html。 它的用途是：将长篇Markdown文档转换为美观、自包含的HTML页面 完整的 Skill 内容见：https://321skill.com/skills/md2html/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
`/md2html 我的系统设计文档.md`，它会自动读取文档，分析内容语言和结构，然后调用技能库中的模板和组件，生成一个带有侧边栏目录、Mermaid架构图、关键点标注框的独立HTML文件，并保存在原文档旁边。
介绍
md2html 是一个专为AI Agent设计的技能，旨在解决长篇技术文档（如设计文档、RFC、事后分析、笔记等）可读性差、难以快速浏览的问题。它将这些Markdown文档转换为一个独立的HTML文件，将冗长的段落和列表转换为可视化的图表、步骤卡片和醒目的标注框，极大提升了文档的扫描效率和阅读体验。
使用时，只需通过AI Agent（如Claude）调用 /md2html 命令并指定Markdown文件路径，技能便会读取预设的HTML模板和组件库，自动分析文档结构、识别语言，并生成包含Mermaid图表、侧边栏目录、主题切换等功能的精美HTML页面。整个过程自动化，用户无需手动编写任何HTML或CSS代码。
这个技能非常适合需要频繁撰写、审阅或分享技术方案、项目规划、运维手册的工程师、技术文档写作者和团队负责人。当面对一份动辄数千字的Markdown规格书或设计文档时，它能帮你快速生成一个易于演示和分发的可视化版本。
与普通的Markdown转HTML工具相比，md2html的核心区别在于其深度集成于AI工作流，并内置了针对技术文档优化的专业组件库（如步骤时间线、优缺点对比卡片、可折叠区块等），生成的页面具有统一、专业的视觉风格（Claude橙色主题），且完全自包含，无需网络即可查看图表。
核心特点
核心区别在于：1) 深度集成AI Agent工作流，通过一条指令即可完成从分析到生成的全过程；2) 内置了专为技术文档设计的丰富可视化组件库（如步骤卡片、标注框、对比卡片），而非简单的格式转换；3) 生成的HTML是单文件、自包含的，内置了Mermaid图表引擎和主题切换，无需依赖外部网络或样式文件。
注意事项
不适合需要高度自定义样式、或源Markdown文档结构极其不规则且无法被预设组件匹配的场景。
常见问题
md2html支持哪些类型的图表？
通过集成Mermaid，支持流程图、序列图、甘特图、饼图等多种技术图表。
生成的HTML文件能在没有网络的情况下查看吗？
可以，所有CSS、JavaScript（包括Mermaid）都内嵌在单个HTML文件中，是完全自包含的。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/md2html/raw/index.md 读取 md2html 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/md2html/raw/index.md（查看排版版本）