前言¶

在文本加工流程里，md 经常被当作中间层：网页分发需要 html，出版交付需要 docx，回头还要从 PDF、PPT、网页里取回干净 md。手工串联 pandoc、markitdown 等工具，容易出现版式不稳定、图片和目录丢失、页眉页脚缺位等问题。下面介绍的这个 Skill 把这些方向收进同一处，用统一触发词驱动。

这是什么¶

话术Markdown转HTML 是一个社区来源的 Agent Skill，坐标 @user_3c6cb52e/huashu-md-html-gii0，由 user_3c6cb52e 发布，版本 1.0.0，分类 office-efficiency，标签 requires_api_key=false。它围绕「md 生产，多端消费」组织四类转换能力，让 md 作为文本中间层，再按用途输出 html 或 docx。

核心功能¶

1、文件转 md：借助 Microsoft markitdown，把 PDF、DOCX、PPTX、XLSX、HTML、图片、音频、YouTube、EPub、ZIP 等转成干净 md。

2、md 转 html：提供两种模式。兜底模式由 Pandoc 套用 4 套精挑模板直接生成，不消耗 token；视觉艺术设计师模式由 AI 读懂内容，推荐 3 个差异化方向，并为内容定制视觉表达，审美上继承 huashu-design 的反 AI slop 取向。

3、html / URL 转 md：html-to-markdown 与 trafilatura 配合，把 html 或 URL 内容尽量无损转回 md。

4、md 转 docx：基于 python-docx 生成出版社级 docx，包含专业排版、自动嵌图、封面、目录、页眉页脚，面向纸质书审校、投稿、出版交付。

安装与启用¶

官方地址：

https://api.skillhub.cn/user_3c6cb52e/huashu-md-html-gii0

SkillHub 页面：

https://www.skillhub.cn/skills/user_3c6cb52e/huashu-md-html-gii0

已抓取资料未提供该 Skill 的具体安装命令、目录或配置字段，本文不补写。它基于通用 SKILL.md 格式；启用后在对话中直接说出触发词即可调用。

典型用法¶

官方列出的触发词包括：md转html、html转md、pdf转md、docx转md、pptx转md、xlsx转md、文件转md、URL转md、文档转md、转markdown、做html、生成html、网页转。

可复现的调用表达如下：

把这份 PDF 转成 md
把刚得到的 md 生成 html
把这个 URL 转回 md
把 md 做成出版交付用的 docx

方向选择上，面向网页阅读走 md 转 html；需要归档或继续编辑走 html 转 md；面向印刷审校走 md 转 docx。

适用场景与注意¶

适合把 md 作为统一中间层、再分发给网页或出版流程的人，尤其是书稿、报告、课程资料、论文等长文本场景。

1、模式取舍：只要稳定版式且不耗 token，走兜底模式；需要差异化视觉表达时再走视觉艺术设计师模式。

2、来源限制：文件转 md 依赖 markitdown 可解析的类型；图片、音频、YouTube 等非文本来源会先解析为文本内容，复杂版式可能丢失。

3、URL 转 md：trafilatura 适合抽取文章正文；对强依赖脚本渲染或登录态的站点，可能取不到完整内容。

4、docx 输出：偏出版交付，精细样式控制不如手工配置 Word 灵活；审校前仍需检查分节、页眉页脚和图片位置。

结尾¶

它的价值在于把「文件进、md 中、html/docx 出」的流程固定下来，减少在多个工具之间手工搬运。官方地址：https://api.skillhub.cn/user_3c6cb52e/huashu-md-html-gii0