
这个插件能做什么
把电脑中的 .html、.htm 文件批量转换成 .docx,保留文字、标题、列表、常见表格和图片,供 Microsoft Word 或 WPS 后续编辑。每个 HTML 生成一份 Word,文件夹层级保持不变。它不修改原 HTML,也不会覆盖已有 Word。
转换不是网页截图:正文和表格可编辑,SVG 图形会变成 PNG 图片。复杂网页布局与浏览器显示可能不同,交付重要文档前应检查结果。
开始前的准备
将工具箱更新到 1.6.12 或更新版本,再安装“HTML文档转Word”插件。旧宿主缺少图片处理 SDK,不能完成本插件转换。
备份需要处理的 HTML 及其资源文件夹。
将 HTML、相对引用的图片和 CSS 放在同一个输入目录范围内。例如
报告.html引用images/图表.svg,请一并保留images文件夹,不要只复制 HTML。准备一个有写入权限和足够空间的输出文件夹。建议与输入目录分开,便于核对。
完成一次转换
打开插件,进入“操作”页。
点击“HTML目录”右侧的“选择”。也可以把文件夹或 HTML 文件拖到输入区或文件列表。
需要处理子文件夹时,先打开“包含子目录”,再点“加载文件”。改变这个开关后,需要重新加载列表。
点击“输出目录”右侧的“选择”。也可以向输出区拖入一个文件夹,不能拖入文件。
检查文件列表。每次加载或拖入会重新建立列表,不会在旧列表中重复追加;右侧“移除”或右键菜单可以排除不需要处理的文件。“清空”只清列表,不删除原文件。
如需调整字体、页面或图片策略,先进入“配置”页设置,再返回“操作”。
点击“开始转换”。只有在备份提示框中点击 “我已备份” 才会开始;点击“取消”不会创建输出或启动转换。
等待队列完成后,在文件列表中查看处理结果;每行“详情”会显示输出位置,可按该路径打开生成的 Word 文件。
结果示例
输入目录:
资料/
项目说明.html
images/标志.svg
子目录/报价单.htm
开启“包含子目录”后,输出目录会得到:
Word结果/
项目说明.docx
子目录/报价单.docx
如果同名 Word 已存在,“自动添加序号”会生成 项目说明 (1).docx 等新文件;“跳过已有文件”则保留原结果,并把该项标为“已跳过”。.html 与 .htm 同名时也按此规则处理。

所有配置项
设置自动保存,重新打开插件后恢复。任务开始时固定本次配置,运行期间不能修改转换设置。
本地资源路径按 HTML 所在位置解析,必须落在输入目录内。要引用上级目录中的图片,应选择能够同时包含 HTML 与图片的更上层输入目录。符号链接和目录联接不能用于越过此边界。不同磁盘或不同共享目录的文件请分批处理。
暂停、继续、取消和返回
暂停:请求暂停队列;当前文件完成后暂停,不会在写入一半时强行截断。
继续:接着处理剩余文件。
取消:停止接纳后续文件,当前未完成文件不会发布成新的 Word;此前已完成的结果保留。图片解码或文档生成可能需要等待当前运算结算,并非瞬间中断。
返回/关闭:仍有任务时,宿主会提示是否强制中止。确认离开后,未完成任务取消;重新进入后可以重新转换。
置顶:让当前工具箱窗口保持在其它窗口前方,再点一次取消。
如何查看成功、失败和警告
列表上方的计数按钮可以筛选等待、成功、跳过、失败或取消的文件。筛选只改变显示,不改变转换队列。
每行进度和状态旁的“详情”可查看输出位置、失败原因或警告。警告模式下的“已完成”只代表已生成文档,不表示缺失资源已被补齐;请阅读详情并打开结果确认。
常见问题
图片为什么缺失?
先检查图片是否还在原来的相对路径中,文件名与编码是否正确;网络图片需显式打开网络资源选项。图片不能越出输入目录,也不能超过限制。默认严格策略会将该文件标为失败;如果接受缺图文档,可以改用警告模式。
为什么与浏览器看到的网页不同?
本插件转换静态 HTML 和常见 CSS,不执行 JavaScript,也不是浏览器完整排版引擎。Flex、Grid、绝对定位、交互组件、iframe、canvas、音视频、CSS 背景图以及复杂打印样式不保证保真。脚本和交互资源不会执行。外部 CSS 支持普通 <link rel="stylesheet">;包含 @import 时请先合并样式表,或接受明确警告。建议先用一两个代表样本检查效果,再批量转换。
文字乱码或字体变化怎么办?
尝试手动选择正确编码;确认原 HTML 本身能正常显示。Word/WPS 使用本机字体,未安装指定字体时可能替换。中文 SVG 也依赖本机可用字体。
文件失败后会不会影响其它文件?
单个文件失败会记录原因并继续队列。原 HTML 保持不变,已存在的 Word 不会被覆盖。检查失败详情,修复资源或配置后重新加载再试。
可以处理多大的文件?
一次最多加载 2,000 个 HTML;每个 HTML 最多 8 MiB,单张外部图片最多 8 MiB,单份外部 CSS 最多 2 MiB,每篇文档连同读取资源总量最多 32 MiB。图片解码最多 16,777,216 像素,网络资源读取最长 20 秒。批次顺序处理,以限制内存占用;超大或极复杂网页应拆分后转换。
生成文件打不开怎么办?
先看该项是否真的完成,确认打开的是 .docx 而不是 HTML。尝试当前版本 Word 或 WPS;如果仍失败,保留原 HTML、关联资源和错误详情供定位,不要覆盖备份。插件会检查 DOCX 包结构,但不能代替对所有办公软件版本及复杂排版的人工验收。