MD转HTML还在踩坑？这个开源工具一键生成完全自包含的GitHub风格文件

写过 Markdown 的同学，一定被这个问题折磨过：本地 Typora 渲染得好好的，一发到网上，表格歪了、代码高亮没了、mermaid 图直接显示源码——崩溃。

今天挖到一个开源工具，专治这种「Markdown 渲染不统一」的硬伤。

md-to-html：把 Markdown 变成完全自包含的 HTML 文件

这个 Skill 来自 inventage-ai/claude-code 仓库（mcp-marketplace 热门工具），它的核心功能就一个：把 .md 文件转化成完全自包含的 HTML，带 GitHub 官方样式，而且零外部依赖。

支持的功能：

• 完整 GFM 规范：表格、删除线、自动链接、任务列表，全部原生支持
• Mermaid 图表：直接识别 ```mermaid 代码块，渲染成可交互的流程图/架构图
• GitHub 样式内联：自动注入 github-markdown-css，支持浅色/深色模式跟随系统
• 完全离线：CSS 和 JS 全部内联到 HTML 里，不需要联网，发送给他人也能正常显示
• Node.js 驱动：一行命令 node md-to-html.mjs [output.html]，无需安装依赖

使用方式

安装后运行：

node ${CLAUDE_PLUGIN_ROOT}/skills/md-to-html/scripts/md-to-html.mjs output.html

不加参数则自动在同目录下生成同名 .html 文件。GitHub 风格预览，直接拖进浏览器就能看。

什么时候用？

• 写技术文档需要 PDF/HTML 单文件交付
• GitHub README 想本地预览最终效果
• 文档要发到不支持 Markdown 的平台（内部系统、邮件附件等）
• 博客静态生成前想看完整渲染效果

实际体验

之前用 pandoc 转 HTML，代码高亮要配 highlight.js，表格样式要自己写 CSS，mermaid 更是要手动引入 CDN——一套下来比写文档本身还累。这个 Skill 把这些全部封装好了，输出就是一个 HTML 文件，微信里直接点开都能正常显示，体验非常丝滑。

适合人群：技术写作者、前端开发者、文档工程师，以及所有被「Markdown 发出去就变样」折磨过的人。

GitHub：https://github.com/inventage-ai/claude-code

GitHub: https://github.com/inventage-ai/claude-code