如何在DocuSign XML邮件模板中添加含URL的HTML注释？

问题背景 #

我用DocuSign开发存储在XML文件中的邮件模板，为了让模板在多数邮箱正常显示且适配Outlook桌面端，添加了HTML条件注释代码段（已将URL中的&转义为&），但保存时出现语法错误。排查后确认错误源于注释内的URL部分，移除URL后可正常保存。需求是让Outlook桌面端加载注释内的头部内容，而非外部内容。

原出错代码段：

<td>
  <!--[if mso]>
  <table width="50%">
    <tr>
      <td><a href="https://www.page.com/en-ca"><img width="620" src="https://page--page.page.page.page.com/page/page.ImageServer?id=0000A0000056se5&amp;amp;oid=00E8E000000F7CG&amp;amp;lastMod=1005000662000" style="text-align: right; width: 207px; border: 0; text-decoration:none; vertical-align: baseline;"></a></td>
    </tr>
  </table>
  <div style="display:none">
    <![endif]-->
    <a href="https://www.page.com/en-ca"><img class="header-image" alt="Omnipod Header" src="https://page--page.page.page.page.com/page/page.ImageServer?id=0000A0000056se5&amp;amp;oid=00E8E000000F7CG&amp;amp;lastMod=1005000662000"></img></a>
    <!--[if mso]>
  </div>
  <![endif]-->
</td>

错误原因 #

XML解析器不支持嵌套注释结构，HTML条件注释的写法（<!--[if mso]> ... <![endif]-->）会被XML误判：XML会将<!--[if mso]>识别为注释起始，直到第一个-->（即<![endif]-->中的-->）就结束注释，导致后续HTML标签暴露在XML结构中，引发语法错误。同时，URL中的转义字符在混乱的解析逻辑下也会被错误识别。

修复方案 #

将整个Outlook条件注释块用XML的<![CDATA[ ... ]]>包裹，让XML解析器把内部内容当成纯文本处理，避免解析错误。同时保持URL中的特殊字符转义正确（&转义为&）。

修复后的代码：

<td>
  <![CDATA[
  <!--[if mso]>
  <table width="50%">
    <tr>
      <td><a href="https://www.page.com/en-ca"><img width="620" src="https://page--page.page.page.page.com/page/page.ImageServer?id=0000A0000056se5&amp;amp;oid=00E8E000000F7CG&amp;amp;lastMod=1005000662000" style="text-align: right; width: 207px; border: 0; text-decoration:none; vertical-align: baseline;"></a></td>
    </tr>
  </table>
  <div style="display:none">
  <![endif]-->
  ]]>
    <a href="https://www.page.com/en-ca"><img class="header-image" alt="Omnipod Header" src="https://page--page.page.page.page.com/page/page.ImageServer?id=0000A0000056se5&amp;amp;oid=00E8E000000F7CG&amp;amp;lastMod=1005000662000"></img></a>
  <![CDATA[
  <!--[if mso]>
  </div>
  <![endif]-->
  ]]>
</td>

说明 #

• <![CDATA[ ... ]]>会让XML解析器忽略内部所有标签和特殊字符，按纯文本处理，完美适配HTML条件注释的语法。
• 保留URL中的&转义，确保最终渲染为HTML时能正确解析为&。
• 修改后，Outlook桌面端仍能正常识别条件注释加载指定内容，其他邮箱加载外部内容，同时XML文件可正常保存无语法错误。

内容的提问来源于stack exchange，提问作者Arturo Corona de la Cruz