Google Apps Script导出Google Doc至HTML格式丢失原因咨询

以下是Google Docs模板中容易导致HTML导出后样式丢失/失效的元素及规避方案：

• 自定义/复杂列表样式
  非默认的项目符号（如自定义图片、特殊符号）、多级嵌套且混合样式的列表，导出HTML时会丢失列表结构或样式。
  规避：仅使用Docs内置的默认圆点/数字编号列表，避免自定义列表样式，多级列表尽量保持统一层级格式。

• 复杂表格格式
  表格的单元格背景色、自定义边框样式、合并单元格+多格式组合，会导致导出后颜色、加粗等样式完全丢失，甚至布局混乱。
  规避：表格仅保留基础结构，用默认细边框，单元格内仅用基础加粗/倾斜样式，不要设置单元格背景色，避免合并单元格；若需特殊表格样式，在导出后的HTML中通过CSS补充。

• 非基础文本样式
  文本突出显示、自定义RGB颜色、彩色下划线、渐变文字这类特殊样式，导出HTML时会被忽略；多层嵌套的混合样式（如一段文字同时有3种颜色+加粗+倾斜）也容易失效。
  规避：仅使用基础文本格式：加粗、倾斜、普通下划线，文字颜色选用Docs内置的基础色系，避免多层复杂样式嵌套。

• 自定义段落样式
  手动设置的自定义段落间距、首行缩进，或非内置的自定义段落样式，会导致导出的CSS结构混乱，影响后续所有元素的样式。
  规避：段落使用默认“普通文本”样式，间距选用内置的单倍/1.5倍行距；标题使用Docs内置的H1-H6样式，不要手动调整字号+加粗模拟标题。

• 嵌入对象与特殊元素
  Docs中的图片、绘图、文本框等嵌入元素，导出HTML时会破坏整体DOM结构，导致周围文本的样式丢失。
  规避：模板中仅保留纯文本内容，图片等元素后期在HTML中通过标签添加，不要使用Docs的绘图或文本框功能。

额外调试建议 #

导出HTML后，直接在浏览器中打开查看样式，重点检查<ul>/<ol>的列表样式、<table>/<td>的属性是否完整。可以在导出的HTML头部添加基础CSS重置代码，确保Gmail等邮件客户端能正确渲染样式：

body { font-family: Arial, sans-serif; line-height: 1.5; }
ul, ol { margin-left: 2em; padding-left: 0; }
strong { font-weight: 700; }
em { font-style: italic; }
table { border-collapse: collapse; margin: 1em 0; }
td, th { border: 1px solid #333; padding: 0.5em; }

内容的提问来源于stack exchange，提问作者Francisco Cortes