word转html样式丢失主因是其“网页兼容模式”主动降级以适配ie6，非bug；实操需在“web选项”中勾选嵌入字体、设utf-8编码，禁用主题，统一应用标题样式，pandoc转换加--standalone与css，清理不可见字符，处理图片路径及命名。
Word 转 HTML 时样式丢失，是因为 docx 里没真正“保存为网页”
直接用 Word “另存为网页”看似最简单，但默认会删掉很多样式、内联 CSS、字体定义，甚至把表格转成图片。这不是 bug，是 Word 的“网页兼容模式”主动降级——它优先保证 IE6 能打开，不是为了现代前端开发。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在 Word 中点「文件 → 另存为 → 浏览 → 保存类型选
网页 (*.htm; *.html)→ 点「保存」前，务必点「工具 → Web 选项」→ 勾选保存所有嵌入的字体和始终保存为 UTF-8 - 如果内容含中文或特殊符号，
Web 选项 → 编码必须设为UTF-8，否则出现乱码不是编码问题，是 Word 没写对<meta charset="utf-8"> - 避免使用 Word 的「主题」和「设计灵感」，它们生成的 CSS 是内联 + 冗余 class，且依赖 Office CDN，离线就断样式
用 pandoc 转换后结构混乱，关键在 HTML 模板和过滤器
pandoc 默认输出的是语义化 HTML（比如用 <aside></aside> 包注释），但 Word 原文没语义，它只能靠样式名猜——比如把「标题 1」转成 <h1></h1>，但若你手动加了粗+居中却没套标题样式，它就当普通段落处理。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 转换前，在 Word 中统一用「样式窗格」应用
标题 1、标题 2、正文，别只靠格式刷；pandoc不读字体/颜色，只读样式名 - 命令里加
--standalone -c style.css生成完整 HTML（含），否则只是片段，粘进页面会缺基础样式 - 遇到表格错位，加
--css https://cdn.jsdelivr.net/npm/pandoc-css@1.0.0/pandoc.css或用--filter pandoc-fignos避免编号塌陷
转出的 HTML 在浏览器里缩进错乱，大概率是 Word 的制表符和空格没清理
Word 里看着整齐的段落，实际混着 、\t、 （中文全角空格）、甚至零宽空格 。浏览器渲染时，这些字符宽度不一致，CSS 的 white-space 一变就全乱。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用 VS Code 打开转出的 HTML，搜索
\t，批量替换成单个空格；再开「显示不可见字符」确认有没有隐藏 Unicode 字符 - 在
上加内联样式：style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;"，避免 Word 插入的Times New Roman或SimSun导致行高突变 - 如果原文有代码块，Word 通常用等宽字体+手动空格缩进，
pandoc会转成<pre class="brush:php;toolbar:false;"><code></code>，但缩进仍可能被浏览器合并——加 <code>white-space: pre-wrap;</code> 到 <code>code</code> 标签上</pre>
图片路径失效或显示为红叉，是因为相对路径没对齐或未导出资源
Word 自带的「另存为网页」会生成一个 xxx_files/ 文件夹，里面是图片、CSS、JS，但 HTML 里的 src 是相对路径，比如 src="xxx_files/image001.png"。一旦你移动 HTML 文件，或上传到服务器没同步整个文件夹，图片就 404。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
pandoc -s --extract-media=.把图片自动解包到当前目录，并生成 base64 内联图（加--self-contained）——适合小文档，不用管路径 - 如果必须保留外链，确保上传时
.html和同名_files文件夹在同一级，且服务器允许访问下划线开头的目录（有些静态托管服务默认屏蔽） - 检查图片文件名是否含中文或空格：Word 可能生成
截图 2024-05.png，但 URL 中空格会被转成%20，部分老服务器不认；重命名为screenshot_202405.png更稳妥
最麻烦的不是转不出来，是转出来的 HTML 看着像，但一改样式或换环境就崩——因为 Word 从不告诉你它偷偷塞了多少条件注释、VML 代码、或者 Office 特供的 o:xxx namespace。真要长期维护，不如把 Word 当草稿，用 Typora 或 Obsidian 写完再导出，省去一半救火时间。
