手写Markdown转HTML脚本？用markdown-to-html Skill直接搞定，真的救命了😭🔥

这个Skill是干嘛的

做过静态站点或者写过文档工具的人都懂那种痛——Markdown转HTML看起来简单，真正动手写转换脚本的时候，代码块嵌套、数学公式、表格对齐、折叠区块……一个个边界情况能把人逼疯。markdown-to-html这个Skill就是专门解决这个问题的，覆盖marked.js、pandoc、gomarkdown三大转换引擎，以及Jekyll、Hugo两大静态站点框架，一个Skill把整条链路都打通了。

核心功能

这个Skill的能力范围比你想象的宽得多，不只是简单的标签替换。

• 基础Markdown转HTML：标题、段落、链接、列表、表格，全部精准映射到对应HTML标签，包括对齐属性（left/center/right）都处理得干净利落。
• 代码块转换：自动生成带语言标识的class='language-xx'属性，方便接入highlight.js等语法高亮库。
• 数学公式支持：行内公式用$...$，块级公式用$$...$$，转换结果是标准MathML，浏览器直接渲染。
• 折叠区块：<details>/<summary>结构内部的Markdown内容也能正确转换，不会出现嵌套失效的问题。
• 多引擎支持：marked.js走Node.js生态，pandoc支持PDF/Word/LaTeX多格式输出，gomarkdown面向Go项目，三条路都给你铺好了。
• 模板系统集成：Jekyll用Kramdown/CommonMark，Hugo用Goldmark，配置文件怎么写、哪些坑要避，Skill里都有现成的参考。

适用平台

markdown-to-html Skill完美适配当前主流AI编程助手。无论你用的是Cursor、GitHub Copilot、Claude Code，还是OpenAI Codex、Gemini Code Assist、文心快码、腾讯云CodeBuddy、华为云CodeArts，加载这个Skill之后，AI对转换逻辑、引擎差异、安全处理的上下文理解会直接上一个台阶。你不用再反复解释”我用的是marked.js”或者”我在Hugo项目里”，AI直接就能给出精准的代码和配置。

实操代码示例

用marked.js做最基础的转换，三行代码搞定：

import { marked } from 'marked';
const html = marked.parse('# HelloThis is **bold**.');
console.log(html);

如果输入来源不可信，记得套一层DOMPurify，这是安全底线：

import { marked } from 'marked';
import DOMPurify from 'dompurify';
const safeHtml = DOMPurify.sanitize(marked.parse(untrustedMarkdown));

Go项目里用gomarkdown，加上自定义Parser和Renderer扩展能力更强：

extensions := parser.CommonExtensions | parser.AutoHeadingIDs
p := parser.NewWithExtensions(extensions)
doc := p.Parse(md)
htmlFlags := html.CommonFlags | html.HrefTargetBlank
renderer := html.NewRenderer(html.RendererOptions{Flags: htmlFlags})
output := markdown.Render(doc, renderer)

pandoc命令行一句话生成完整HTML文档：

pandoc input.md -s -o output.html

优势分析

市面上单独介绍某一个工具的教程很多，但把marked.js、pandoc、gomarkdown、Jekyll、Hugo放在同一个知识体系里的Skill几乎没有。这个Skill的核心优势在于跨引擎的横向对比视角——同样是GFM支持，marked.js是97%，pandoc是完整支持，gomarkdown是高度支持，选哪个取决于你的项目语言和部署环境，Skill里直接给你列清楚了。

另外，安全处理这块很多教程都一笔带过，这个Skill专门标注了每个引擎的XSS风险点，并给出了对应的sanitizer推荐：marked.js用DOMPurify，gomarkdown用Bluemonday，pandoc用--sandbox模式。这些细节在生产环境里真的很关键。

应用场景

• 文档站点生成：把项目的README.md批量转成HTML页面，配合Hugo或Jekyll自动化发布，省去手动维护HTML的麻烦。
• 博客系统开发：用Node.js写博客后端，marked.js处理用户提交的Markdown内容，DOMPurify过滤XSS，输出安全的HTML片段。
• Go微服务文档渲染：API文档用Markdown写，服务启动时用gomarkdown动态渲染成HTML，不依赖外部工具链。
• 多格式文档输出：技术规范文档需要同时交付HTML版和Word版，pandoc一条命令搞定，不用维护两套源文件。
• 数学/科学内容平台：教育类网站需要渲染LaTeX公式，Skill里的MathML转换方案可以直接复用，不用从头研究规范。

最佳实践

几个工程化落地的关键点值得注意。批量转换时做好错误隔离，单个文件解析失败不应该中断整个批处理流程，建议用try/catch包裹每个文件的转换逻辑并记录失败列表。

输出文件命名保持一致性，建议直接把.md后缀替换为.html，目录结构保持不变，这样静态服务器的路由配置最简单。

Hugo项目里慎用unsafe = true，Goldmark默认会过滤原始HTML，如果你的Markdown里有自定义HTML片段需要保留，才开这个选项，不要无脑全局开启。

Jekyll项目升级Ruby 3.0+之后，记得跑一下bundle add webrick，不然本地serve会直接报错，这个坑踩过的人都懂。

这类转换工具和配置在实际项目里积累下来会越来越多，统一放到Skill优仓管理是个不错的选择，团队成员直接复用，不用每次都重新找文档或者重写配置。