如何配置docx4j-ImportXHTML仅使用Word文档样式渲染标题？

可以配置docx4j-ImportXHTML完全使用Word文档样式，核心是禁用默认CSS加载并强制段落样式优先于内联CSS，以下是具体实现步骤：

1. 关闭内置默认样式表加载 #

docx4j-ImportXHTML自带的默认CSS是导致无显式CSS的h3出现默认字号的根源，通过代码禁用：

XHTMLImporterImpl importer = new XHTMLImporterImpl(wordprocessingMLPackage);
// 关闭内置默认样式表，避免其覆盖Word样式
importer.getUserAgentSettings().setLoadDefaultStyleSheet(false);

2. 强制忽略CSS中的字体类属性 #

通过格式化选项，让Word段落样式的字体、字号、颜色、间距等属性完全覆盖内联CSS：

FormattingOptions formattingOptions = importer.getFormattingOptions();
// 启用样式应用优先级
formattingOptions.setApplyStyles(true);
// 忽略CSS中会干扰Word样式的属性
formattingOptions.setIgnoreFontFamily(true);
formattingOptions.setIgnoreFontSize(true);
formattingOptions.setIgnoreColor(true);
formattingOptions.setIgnoreSpacing(true);

3. 自定义CssApplier彻底跳过标题的CSS处理 #

如果上述配置仍有残留内联样式，可自定义CssApplier，直接跳过标题元素的CSS解析：

importer.setCssApplier(new CssApplier() {
    @Override
    public void apply(Element e, P p, WordprocessingMLPackage wmlPackage, CssStyle cssStyle) {
        String tagName = e.getTagName();
        // 判断是否为h1-h6标题元素
        if (tagName.matches("h[1-6]")) {
            // 标题仅使用Word段落样式，不处理任何CSS
            return;
        }
        // 非标题元素正常应用CSS
        super.apply(e, p, wmlPackage, cssStyle);
    }
});

4. 确认样式映射与样式存在 #

确保已完成基础配置：

• 从参考DOCX文件复制目标样式到生成的Word文档中
• 启用标题样式映射（代码或配置文件二选一）：
  代码方式：

  System.setProperty("docx4j-ImportXHTML.Element.Heading.MapToStyle", "true");
  

  docx4j.properties文件方式：

  docx4j-ImportXHTML.Element.Heading.MapToStyle=true
  

验证方法 #

转换完成后，打开生成的DOCX文件，通过Word的「样式检查器」查看标题段落：确认文本运行没有直接设置字体、字号、颜色等属性，仅应用了你指定的Word样式。

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