DOCX 转纯净 HTML 发布助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/convert-docx-documents-into-clean-html-for-publishing-workflows-mammoth。
技能介绍
问题背景:Word 文档卡在发布流水线入口
团队的内容生产往往以 .docx 收尾:作者在 Word 里排版完稿,接下来却要发布到网站、导入 CMS,或作为素材进入下游的清洗与分发流程。麻烦在于,.docx 里真正有价值的是标题层级、列表、表格这类语义结构,而文件本身携带的大量信息是 Word 私有的样式规则和本地化排版指令。直接把原始文档丢进流水线,得到的要么是带着一堆 mso- 前缀样式的脏 HTML,要么是格式错乱的文本。
技能如何工作:靠 Mammoth 保留语义、剥离样式
这个技能基于 Mammoth,把 DOCX 到 HTML 的转换封装成一条清晰的处理路径:
- 语义优先:标题映射为
h1–h6,列表映射为ul/ol,表格保留table结构,加粗与强调对应strong/em——而不是复制 Word 的视觉样式。 - 样式剥离:转换过程丢弃 Word 特有的样式表与分页指令,输出的 HTML 干净、结构化,方便后续用 CSS 重新排版或直接入库。
- 面向流水线:输出定位是发布与内容摄取,拿到 HTML 后可以立刻交给渲染层、编辑器或 Markdown 转换环节继续加工。
使用路径很直接:准备一个 .docx 文件,交给 Mammoth 转换,拿到结构化 HTML 后接入发布工作流。Mammoth 本身是跨语言的工具,除 Node.js 环境外也有 Python、浏览器、Java 等实现,技能文档里也提到与 WordPress 等平台的配合。
适用边界与注意点
- 不做视觉保真:字体、颜色、页边距等排版细节不会被保留,输出的 HTML 需要靠目标站点的样式重新渲染。
- 不是文档编辑器:技能解决的是「转换」这一个环节,后续的内容修改请在编辑器或发布系统中完成。
- 复杂文档可能降级:Word 中的域、宏、复杂多级编号等动态内容,转换后可能丢失或降级为静态文本,正式使用前建议抽样验证。
使用场景
- 内容运营收到作者的 DOCX 稿件,需要转成干净 HTML 发布到网站
- CMS 编辑把 Word 文档导入系统时,希望保留标题层级而非样式
- 前端工程师处理客户提交的 DOCX 素材,输出结构化 HTML 继续渲染
- 技术写作把 DOCX 文档转换为 HTML 后托管到文档站点
适合人员
- 内容运营人员:定期把 DOCX 稿件转成 HTML 发布到团队网站
- CMS 编辑:需要导入 Word 文档并保留语义结构
- 前端工程师:为发布流水线处理 DOCX 到 HTML 的转换
- 技术写作者:把 DOCX 文档转成 HTML 托管到文档站点