如何通过Open XML SDK为Word文档添加带HTML格式的文本？

这个问题我之前也碰到过——直接给TextElement.Text赋值确实只会把HTML标签当纯文本输出，因为Open XML的Text元素本身就是用来存储无格式文本的。要保留HTML格式，得把HTML转换成对应的Open XML文档结构，下面给你两种靠谱的方法：

方法一：用原生Open XML的AltChunk导入HTML #

Open XML提供了AlternativeFormatImportPart来导入外部格式（比如HTML、RTF），Word在打开文档时会自动解析这些内容并转换成原生格式。步骤如下：

// 假设你已经获取到WordprocessingDocument实例doc
var mainPart = doc.MainDocumentPart;

// 创建HTML类型的导入部件
var htmlImportPart = mainPart.AddAlternativeFormatImportPart(AlternativeFormatImportPartType.Html);

// 写入合法的HTML内容（先修复你示例里的语法错误，比如<li2>要改成</li>）
string validHtml = "<p>test<br/>test2<ul><li>item1</li><li>item2</li></ul></p>";
using (var stream = htmlImportPart.GetStream())
using (var writer = new StreamWriter(stream))
{
    writer.Write(validHtml);
}

// 创建AltChunk元素关联导入部件
var altChunk = new AltChunk();
altChunk.Id = mainPart.GetIdOfPart(htmlImportPart);

// 将AltChunk插入到文档的目标位置（比如文档末尾）
mainPart.Document.Body.AppendChild(altChunk);

// 保存文档
doc.Save();

注意：这种方式的缺点是，直接解析文档XML时看不到转换后的Paragraph/Run元素，只有AltChunk引用，需要Word客户端打开后才会完成格式转换。

方法二：用第三方库直接转换为Open XML原生元素 #

如果需要直接操作转换后的Open XML元素，可以使用HtmlToOpenXml库，它能直接把HTML字符串转换成对应的Paragraph、ListItem等原生元素。

首先安装NuGet包：

Install-Package HtmlToOpenXml

然后使用代码转换并插入：

using HtmlToOpenXml;

// 假设你要插入到文档Body中
var converter = new HtmlConverter();
var openXmlElements = converter.Parse("<p>test<br/>test2<ul><li>item1</li><li>item2</li></ul></p>");

// 将转换后的元素添加到目标位置
mainPart.Document.Body.Append(openXmlElements);

// 保存文档
doc.Save();

重要提示 #

不管用哪种方法，都要先确保你的HTML语法是合法的——比如你示例里的<li2>是错误标签，必须改成</li>，否则转换过程会出现格式错乱或者失败。

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