Markdown 转 HTML

解决什么问题

当 Markdown 需要发布成网页时，纯转换常常缺少代码高亮、主题适配和移动端阅读体验。markdown-2-html 的目标不是简单拼接标签，而是把 example.md 输出为可独立打开的 example.html，让技术笔记、API 说明和代码示例在浏览器中直接可读。

如何工作

技能围绕单文件 HTML 输出组织转换流程，核心脚本接收输入 Markdown 路径，并可选指定输出路径与页面标题：

• 解析标题、列表、链接、图片、引用、表格等常见 Markdown 语法。
• 为 bash、python、javascript、json、html、css 等代码块生成语法高亮样式。
• 注入亮色与暗黑模式样式，让页面跟随系统主题切换。
• 使用专业等宽字体、语言标签和横向滚动，优化代码块展示。
• 控制桌面端最大宽度并适配移动端边距，保持中文排版可读。

适用边界

适合把静态 Markdown 文档转成轻量网页、分享页或快速验证排版效果；生成的 HTML 是独立单文件，图片仍依赖原链接或相对路径。若代码块没有语言标记，高亮效果可能受限。