写完 README 想直接转 HTML 页面?用这个 GitHub 官方的 markdown-to-html Skill,三行搞定

每次写完 README.md,想直接转成漂亮的 HTML 页面发给同事,结果还得手动调格式——你是不是也这样?

今天挖到一个超实用的 CodingSkill——github/markdown-to-html,来自 GitHub 官方维护的 awesome-copilot 仓库,专门帮你把 Markdown 文件秒变 HTML,而且支持多种主流转换工具

这个 Skill 能干啥?

它不是一个单一工具,而是一套完整的「Markdown → HTML」转换指南。触发条件很简单:

  • 让你”把 md 文件转成 HTML”
  • 让你”渲染 Markdown 为 HTML”
  • 让你”用 Jekyll / Hugo 建静态站”
  • 让你”生成 HTML 文档”

只要说类似这些话,它就自动介入,帮你选择最合适的转换方案。

支持的工具有这些

这是它最厉害的地方——不绑定单一工具,按需切换:

  • marked.js:Node.js 最流行的 md→html 库,CLI 和编程方式都能用,安装 npm install -g marked 就能跑
  • pandoc:瑞士军刀,md→HTML/PDF/DOCX/EPUB 都能行,适合复杂文档转换
  • gomarkdown/markdown:Go 语言实现,适合想在 Go 项目里集成转换能力的开发者
  • Jekyll / Hugo:静态博客框架原生支持 Markdown,自动转 HTML,适合搭博客或文档站

上手有多简单?

以最常用的 marked.js 为例,三行搞定:

安装:npm install -g marked

单文件转换:marked -i input.md -o output.html

带配置:marked -i input.md -o output.html -c config.json

支持 GitHub Flavored Markdown(表格、任务列表、代码高亮),CommonMark 兼容度 98%,Original Markdown 100%。

安全提醒

⚠️ marked.js 本身不消毒输出 HTML,如果你要处理用户提交的 md 内容,记得加 DOMPurify:

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

适合谁用?

  • 写技术文档的开发者(转成 HTML 方便分享)
  • 用 Jekyll/Hugo 搭博客的同学
  • 需要批量把 md 转 HTML 的运营或产品同学
  • 想在静态站里集成 Markdown 渲染的站长

Stars 20,589,29 次安装——GitHub 官方维护,质量有保证。

GitHub 链接:https://github.com/github/awesome-copilot/tree/main/skills/markdown-to-html


GitHub: https://github.com/github/awesome-copilot/tree/main/skills/markdown-to-html

评论区

0 条评论

登录后可评论。

白鹿 12 阅读