python-docx无法直接渲染HTML标签，需用BeautifulSoup解析后映射为docx操作；pandas转Excel再用Word打开会丢失样式结构；推荐docx-gen等专用HTML-to-Docx库。
用 Python 的 python-docx 无法直接写入 HTML 标签
python-docx 本身不解析 HTML，add_paragraph() 或 add_run() 塞进去的 <b>文本</b> 就是纯字符串，不会加粗。想保留样式，得先解析 HTML。
- 推荐用
beautifulsoup4解析 HTML 结构，再按标签类型映射成 docx 操作：比如<h2>→add_heading(text, level=2)，<strong>→run.bold = True - 注意
<img>标签里的src是相对路径时，得手动拼出绝对路径，否则document.add_picture()会报FileNotFoundError - 内联 CSS（如
style="color: red;"）不会被自动识别，需要自己提取并映射到font.color.rgb等属性
用 Pandas 的 to_excel + Word 打开会丢样式和结构
有人试过把 HTML 表格用 pandas.read_html() 读成 DataFrame，再 to_excel()，然后用 Word 打开 Excel 文件——这确实能“显示”，但本质是 Excel 渲染 HTML 表格，不是真正转 Word 文档。
- Word 打开 .xlsx 是调用 Excel 引擎，表格以外的内容（如段落、标题层级、列表）全丢失
- 导出的 .xlsx 若含中文路径或特殊字符，用
openpyxl保存后可能触发编码异常，错误信息类似：UnicodeEncodeError: 'charmap' codec can't encode character - 这不是转换，只是“借道”，不适合交付或自动化流程
headless Chrome + docx-gen 比较靠谱但需 Node.js 环境
如果 HTML 含复杂样式、Flex 布局或自定义字体，服务端渲染仍是更稳的选择。用 Puppeteer 截图再转 PDF 再转 Word 不现实，推荐 docx-gen 这类基于 HTML-to-Docx 的库。
-
docx-gen能处理大部分内联样式和表格，但不支持@media print或 JS 动态插入的内容 - 必须确保 HTML 是完整文档（含
<html><body>），片段 HTML（如只有<div>...）会解析失败，错误提示常为：Error: No root element found - 生成的 .docx 中中文字体默认是 Calibri，要改宋体得在模板里预设
defaultFontName，或手动遍历所有paragraph设置runs[0].font.name
本地双击打开 HTML 自动转 Word？别信浏览器右键“另存为”
Chrome / Edge 的“另存为 → Web Page, Complete”保存的是 .htm + _files/ 文件夹，不是 Word；而“另存为 → Text Files”会清空所有标签，只剩裸文本。
立即学习“前端免费学习笔记（深入）”；
- Windows 上用 Word 直接打开 .html 文件，看似成功，实则依赖 Word 内置的 HTML 渲染引擎，兼容性差：CSS Grid 布局塌陷、
position: sticky失效、SVG 图片变黑块 - Mac 上 Pages 打开 HTML 更不可靠，常卡死或只读取前两屏内容
- 这种“打开即转”方式无法批量处理，也没有 API，不能写进 CI/CD 或定时任务
