Mammoth .docx converter WP 插件｜纯净转换 Word DOCX 为 HTML，清除冗余 Word 格式代码

Mammoth .docx converter 由 Michael Williamson 开发，是一款面向 WordPress 平台的开源文档转换插件。底层基于 mammoth.js JavaScript 库，专门用来将 .docx 文件（Microsoft Word、Google Docs、LibreOffice 均可导出）转换成整洁、轻量化 HTML 代码。

很多站长直接复制 Word 内容粘贴到 WP 编辑器时，会带入大量冗余字体、颜色、间距样式代码，造成页面臃肿、排版错乱。Mammoth 核心思路：优先识别文档语义结构，抛弃多余视觉样式，从根源解决该问题。

官方插件下载地址：https://wordpress.org/plugins/mammoth-docx-converter/
本站汉化中文版地址：

注意：本段内容须成功“回复本文”后“刷新本页”方可查看！

H2 一、核心设计理念

docx 文档内部结构与 HTML 存在巨大差异，很难实现 1:1 视觉复刻。 Mammoth 不追求原样复制字体、字号、颜色等外观样式，而是提取文档语义标签： 例如识别Heading 1标题样式，直接输出<h1>标签，而非堆砌大量内联样式。 适合遵循规范、使用内置样式排版的文档；文档越依赖自定义边框、复杂浮动布局，转换效果越容易出现偏差。最佳实践：写文档时依靠样式区分层级，不要手动随意调整字体格式。

H2 二、支持完整转换内容

✅ 标题层级（Heading1~HeadingN） ✅ 有序列表、无序列表 ✅ 表格（表格边框等容器样式忽略，单元格内文字格式正常解析） ✅ 脚注、尾注 ✅ 内嵌图片 ✅ 粗体、斜体、上标、下标文本格式 ✅ 超链接 ✅ 文本框：文本框内容视作独立段落，放在原段落后方输出

H2 三、自定义样式映射（高级功能）

内嵌样式映射

插件默认自带基础样式映射规则，例如 Heading 1 → <h1>。 如果你在文档中创建了自定义样式，可以写入样式映射规则，告诉 Mammoth 如何转换成对应 HTML 标签与 CSS 类。

示例规则： p[style-name='WarningHeading'] => h1.warning:fresh 含义：将样式名为WarningHeading的段落，转换为带warning类的 h1 标题。

配套提供在线工具，可以把样式映射规则嵌入 docx 文件；语法完整说明参考 mammoth.js 官方文档。 同时支持全局预设样式映射，作用于所有导入文档。

H2 四、自定义配置扩展方式

两种方式实现深度自定义：

1. 开发独立扩展插件 可以编写子插件，注入全局样式映射、自定义文档转换器。典型场景：识别等宽文字段落，自动转为「代码块」样式。
2. 全局 JS 变量 MAMMOTH_OPTIONS WordPress 版本调用 mammoth.js 时会读取全局变量 MAMMOTH_OPTIONS。 要求定义为函数，返回配置对象，直接传入convertToHtml转换方法。 函数第一个参数会传入 mammoth 库实例，方便调用内置工具函数，例如 mammoth.transforms.getDescendantsOfType。 所有可用配置项查阅 mammoth.js 官方文档。

H2 五、适合人群与使用场景

✅ 博客、资讯站点，经常需要把 Word 稿件导入 WordPress
✅ 讨厌 Word 粘贴带来大量冗余 inline CSS、页面代码臃肿
✅ 希望统一网站排版风格，不希望 Word 文档自带的五花八门字体、颜色污染网页
✅ 技术作者，需要批量导入规范结构化文档

⚠️ 局限性提醒

1. 复杂图文混排、表格边框、浮动元素、复杂形状，转换效果有限；
2. 极度依赖作者在 Word 内正确使用「样式」功能；通篇手动调格式的文档转换效果较差；
3. 仅支持 docx，老式.doc 二进制格式无法解析。

写在最后

如果你长期从 Word 向 WordPress 搬运稿件，饱受粘贴后样式错乱、源代码垃圾代码过多困扰，Mammoth 是非常优质的解决方案。它不和编辑器强行同步视觉样式，专注输出干净的语义 HTML，后续依靠主题 CSS 统一控制全站排版，非常适合内容型网站。