alchaincyf/huashu-md-html

这是什么？

核心功能

• 01将 PDF、Office 文件、EPUB、图片、音频、YouTube 和网页 URL 转为 Markdown。
• 02用四套自包含主题把 Markdown 渲染为 HTML，无需外部 CDN。
• 03从网页中提取正文，去除导航、侧栏和广告。
• 04生成带封面、目录、页眉页脚和章节分页的图书式 DOCX。
• 05以 skill 形式运行，可通过 npx skills add 在多种 agent 中安装。

适用场景

• 用 report 主题把 PDF 白皮书做成可阅读的 HTML 页面。
• 把已发布的博客文章归档回 Markdown 源文件。
• 为编辑或投稿系统生成排好版的 DOCX 稿件。
• 把网页技术文档转为结构化 Markdown，供 AI 助手使用。

快速上手

1. 1

   通过 skills.sh 安装该技能

   npx skills add alchaincyf/huashu-md-html
2. 2

   安装 markitdown 依赖

   python3 -m pip install 'markitdown[all]'
3. 3

   安装 pandoc（README 中的 macOS 示例）

   brew install pandoc
4. 4

   将 markdown 文件转换为带样式的 HTML 页面

   python3 scripts/md_to_html.py article.md --theme article -o article.html

使用前须知

• !需要 Python 3 以及 pandoc 等外部工具，部分功能还需额外安装 pip 包。
• !主要设计为 Agent 技能使用，没有独立的图形界面。

标签

常见问题

huashu-md-html 是什么？

一个 Claude Code skill，可将文件和网页转为 Markdown，并把 Markdown 排版成 HTML 或出版级 DOCX。 huashu-md-html 是一组打包成 agent skill 的文档转换脚本。它借助 markitdown，把 PDF、DOCX、PPTX、XLSX、EPUB、图片、音频、YouTube 视频和网页 URL 转为 Markdown；再基于 Pandoc，用 article、report、reading、interactive 四套自包含单 CSS 主题把 Markdown 渲染成 HTML。

huashu-md-html 可以免费使用吗？用的什么许可证？

huashu-md-html 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

huashu-md-html 还在维护吗？

活跃维护中。huashu-md-html 最近一次提交是在 2026年10月13日。

huashu-md-html 适合用来做什么？

用 report 主题把 PDF 白皮书做成可阅读的 HTML 页面。 把已发布的博客文章归档回 Markdown 源文件。 为编辑或投稿系统生成排好版的 DOCX 稿件。 把网页技术文档转为结构化 Markdown，供 AI 助手使用。

huashu-md-html 怎么安装和运行？

通过 skills.sh 安装该技能: npx skills add alchaincyf/huashu-md-html 安装 markitdown 依赖: python3 -m pip install 'markitdown[all]' 安装 pandoc（README 中的 macOS 示例）: brew install pandoc 将 markdown 文件转换为带样式的 HTML 页面: python3 scripts/md_to_html.py article.md --theme article -o article.html

在哪里获取 huashu-md-html？

源代码和安装说明在 GitHub 上：https://github.com/alchaincyf/huashu-md-html