2. AI 输出一键导出 Word！docx4j+poi-tl 实现 Markdown 转 Word 全流程（含自界说样式 + 占位符更换）

1.简介

我们在上一章先容了如果想实现将markdown内容转换为word的话, 如果想要转换后的word内容排版悦目的话, 就必要将其转换过程分为两步

• markdown→html
  
• html→ooxml(Office Open XML) word内容,word元信息本身就是个xml)
  

上一章节我们使用flexmark将markdown内容转换为html内容, 完成了第一步, 本章节我们将先容怎样将html转换为ooxml
2. 情况信息

为了兼容更多的场景, 以是并没有用一些高版本的SDK, 信息如下

1. Java: 8
2. Docx4j: 8.3.10

复制代码

3. Maven

1. <properties>
2.   <docx4j.version>8.3.10</docx4j.version>
3.   <jaxb2.version>1.11.1</jaxb2.version>
4. </properties>
6. <dependencies>
7.   <dependency>
8.     <groupId>org.docx4j</groupId>
9.     <artifactId>docx4j-JAXB-Internal</artifactId>
10.     <version>${docx4j.version}</version>
11.   </dependency>
12.   <dependency>
13.     <groupId>org.docx4j</groupId>
14.     <artifactId>docx4j-ImportXHTML</artifactId>
15.     <version>${docx4j.version}</version>
16.   </dependency>
17.   <dependency>
18.     <groupId>org.docx4j</groupId>
19.     <artifactId>docx4j-JAXB-MOXy</artifactId>
20.     <version>${docx4j.version}</version>
21.   </dependency>
22.   <dependency>
23.     <groupId>org.jvnet.jaxb2_commons</groupId>
24.     <artifactId>jaxb2-basics</artifactId>
25.     <version>${jaxb2.version}</version>
26.   </dependency>
27. </dependencies>

复制代码

4. Html转Docx

1. import lombok.SneakyThrows;
2. import org.docx4j.Docx4J;
3. import org.docx4j.convert.in.xhtml.XHTMLImporterImpl;
4. import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
5. import org.docx4j.openpackaging.parts.WordprocessingML.MainDocumentPart;
6. import org.docx4j.wml.Body;
8. import java.io.File;
10. /**
11. * html 2 docx
12. *
13. * @author ludangxin
14. * @since 2025/10/14
15. */
16. public class HtmlToDocx {
17.     @SneakyThrows
18.     public static void convertHtmlToDocx(String htmlContent, String outputFilePath) {
19.         // 创建 Word 文档包
20.         WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();
21.         MainDocumentPart mainDocumentPart = wordMLPackage.getMainDocumentPart();
22.         // 设置 XHTML 导入器
23.         XHTMLImporterImpl XHTMLImporter = new XHTMLImporterImpl(wordMLPackage);
24.         // 将 HTML 内容导入到 Word 文档中
25.         Body body = mainDocumentPart.getJaxbElement().getBody();
26.         body.getContent().addAll(XHTMLImporter.convert(htmlContent, null));
27.         // 保存 Word 文档
28.         Docx4J.save(wordMLPackage, new File(outputFilePath), Docx4J.FLAG_NONE);
29.     }
31.     public static void main(String[] args) {
32.         String html = "<html><head></head><body><h2>嘉文四世</h2>\n" + "<blockquote>\n" + "<p>德玛西亚</p>\n" + "</blockquote>\n" + "<p><strong>给我找些更强的敌人！</strong></p>\n" + "<table>\n" + "<thead>\n" + "<tr><th>列1</th><th>列2</th></tr>\n" + "</thead>\n" + "<tbody>\n" + "<tr><td>数据1</td><td>数据2</td></tr>\n" + "</tbody>\n" + "</table>\n" + "</body></html>";
33.         convertHtmlToDocx(html, "demo.docx");
34.     }
35. }

复制代码

测试效果如下:

在根目次天生了docx文件, 文件内容如下

天生的文档内容是有样式的, 只不外像字体样式, 包罗表格都是默认样式
但如果项目上要求输出的制式文档大概是模板文件, 对笔墨标题以致是表格都有其样式要求的话, 那就得用一些高阶用法了
5. 自界说样式

如果想要自界说输出的内容样式, 着实就两个思绪:

• 从输出的内容出发: 毕竟是html转的ooxml, 那么可以给html添加css样式给docx4j举行渲染, 但条件是一些简单的css样式
  
• 从word出发: word文件本身就有内置样式而且也可以自界说样式, 以是可以先在模板文件中界说好样式, 然后和输入的内容举行映射
  

5.1 Html添加Css

比如给表格添加样式, 让表格有边框而且有肯定的样式,css样式如下:

1. table{border-collapse:collapse;border-spacing:0;width:100%;margin:1em 0;background-color:transparent;}table th{background-color:#f7f7f7;border:1px solid #ddd;padding:8px 12px;text-align:left}table td{border:1px solid #ddd;padding:8px 12px}

复制代码

1. public static void main(String[] args) {
2.     String html = "<html><head></head><body><h2>嘉文四世</h2>\n" + "<blockquote>\n" + "<p>德玛西亚</p>\n" + "</blockquote>\n" + "<p><strong>给我找些更强的敌人！</strong></p>\n" + "<table>\n" + "<thead>\n" + "<tr><th>列1</th><th>列2</th></tr>\n" + "</thead>\n" + "<tbody>\n" + "<tr><td>数据1</td><td>数据2</td></tr>\n" + "</tbody>\n" + "</table>\n" + "</body></html>";
3.     convertHtmlToDocx(html, "demo.docx");
4. }

复制代码

测试效果如下:

此时着实如果想要输出的内容样式悦目, 通过界说css根本可以满意了, 但如果是制式文档对行间距,字间距,字体型号,标题,等有严格的要求, 如果这些都通过css界说的话 有点贫苦, 毕竟人家制式的文档本身已经界说好了, 那么就可以使用下面的方式
5.2 Html映射WordStyleId

我们可以先看一下word的内置样式, 我这里使用的是mac office,windows 和 wps 有些许差异

从上图中可以看到, word着实是有很多内置样式的, 而且可以新建样式, 下面也可以筛选列表
我们经常在快捷样式列表中选择的样式着实就是从这里来的

我们先手动新增一个自界说的样式 如下:

然后通过docx4j获取全部的wordstyle列表 如下:

1. private static WordprocessingMLPackage wordMLPackage;
3. @BeforeAll
4. @SneakyThrows
5. public static void init_mainDocumentPart() {
6.           File templateFile = new File("demo.docx");
7.           wordMLPackage = WordprocessingMLPackage.load(templateFile);
8. }
10. @Test
11. @SneakyThrows
12. public void given_doc_template_when_extract_style_then_return_style_list() {
13.           final StyleDefinitionsPart sdp = wordMLPackage.getMainDocumentPart().getStyleDefinitionsPart();
14.           List</head><body><h2 class="1">嘉文四世</h2><blockquote><p class="customBodyText">德玛西亚</p></blockquote><p class="customBodyText"><strong>给我找些更强的敌人！</strong></p><table><thead><tr><th>列1</th><th>列2</th></tr></thead><tbody><tr><td>数据1</td><td>数据2</td></tr></tbody></table></body></html>";
15.           final MainDocumentPart mainDocumentPart = wordMLPackage.getMainDocumentPart();
16.           XHTMLImporterImpl importer = new XHTMLImporterImpl(wordMLPackage);
17.           // CLASS_TO_STYLE_ONLY：只认 class，不管 style 和 <strong>/<em> 等标签，相当于「纯 CSS 类驱动样式」
18.           // CLASS_PLUS_OTHER：class 是基础样式，style 和内联标签是补充 / 覆盖，相当于「类样式 + 局部微调样式」
19.           // IGNORE_CLASS: 忽略class样式
20.           importer.setParagraphFormatting(FormattingOption.CLASS_TO_STYLE_ONLY);
21.           importer.setRunFormatting(FormattingOption.CLASS_TO_STYLE_ONLY);
22.           importer.setTableFormatting(FormattingOption.CLASS_TO_STYLE_ONLY);
23.           // html转ooxml
24.           final List<Object> docxContent = importer.convert(html, null);
25.           final List<Object> docxOldContent = mainDocumentPart.getContent();
26.           // 清空模板内容 并 添加新的内容
27.           docxOldContent.clear();
28.           docxOldContent.addAll(docxContent);
29.           Docx4J.save(wordMLPackage, new File("newDemo.docx"), Docx4J.FLAG_NONE);
30. }

复制代码

测试效果如下:
一级标题和自界说样式都映射完成了

6. 占位符更换

联合上述的功能, 已经能很好的输出html到word中了, 但项目上又有新的需求了, 不光是将markdown→html→word, 还必要将大模子辨认到的内容一同输出到模板文件中去, 也就是终极输出的内容有两部门

• 大模子提取到的职员信息, 如姓名工作住址等
  
• 大模子总结的职员形貌信息(markdown)
  

着实第二步内容使用doc4j已经实现了, 如今必要通过占位符的方式输出职员根本信息到word中, 这个着实很长处置惩罚, 可以使用poi-tl实现占位符的更换
6.1 Maven

1. <dependency>
2.           <groupId>com.deepoove</groupId>
3.           <artifactId>poi-tl</artifactId>
4.           <version>1.12.0</version>
5. </dependency>

复制代码

6.2 实现

1. @Test
2. public void given_template_doc_and_content_when_replace_then_replace() {
3.     final Configure templateEngineConfigure = Configure.builder().build();
4.     File templateFile = new File("demo.docx");
5.     File outputFile = new File("newDemo.docx");
6.     Map<String, Object> data = new HashMap<>();
7.     data.put("user", "嘉文四世");
8.         data.put("summoner", "张铁牛");
9.     data.put("position", "打野");
10.     data.put("dialogue", "给我找些更强的敌人");
11.     try (XWPFTemplate template = XWPFTemplate.compile(templateFile, templateEngineConfigure)) {
12.             template.render(data).writeToFile(outputFile.getAbsolutePath());
13.         }
14.         catch (IOException e) {
15.             log.error("failed to replace template word placeholder", e);
16.             throw new RuntimeException(e);
17.         }
18. }

复制代码

模板内容如下:

测试效果如下:
不但实现了占位符的更换, 而且也生存了占位符本身的样式, 这就很舒服了

7. 封装工具类

为了更方便的调用docx4j和poi-tl操纵word, 我们可以封装一个工具类去更方便的调用, 比如可以通过传入一个map对象然后实现主动更换占位符和markdown内容渲染, 最好是通过链式调用一行代码就办理斗斗, 没错 它来了

1. import com.deepoove.poi.XWPFTemplate;
2. import com.deepoove.poi.config.Configure;
3. import lombok.SneakyThrows;
4. import lombok.extern.slf4j.Slf4j;
5. import org.docx4j.convert.in.xhtml.FormattingOption;
6. import org.docx4j.convert.in.xhtml.XHTMLImporterImpl;
7. import org.docx4j.openpackaging.exceptions.Docx4JException;
8. import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
9. import org.docx4j.openpackaging.parts.WordprocessingML.MainDocumentPart;
10. import org.docx4j.wml.Body;
12. import java.io.File;
13. import java.io.IOException;
14. import java.io.InputStream;
15. import java.io.OutputStream;
16. import java.nio.file.Files;
17. import java.util.ArrayList;
18. import java.util.List;
19. import java.util.Map;
20. import java.util.Optional;
21. import java.util.function.BiFunction;
23. /**
24. * doc操作工具类
25. *
26. * @author ludangxin
27. * @since 2025/10/14
28. */
29. @Slf4j
30. public class Docs {
31.     @SneakyThrows
32.     public static DocBuilder builder() {
33.         return new DocBuilder().wordMLPackage(WordprocessingMLPackage.createPackage());
34.     }
36.     @SneakyThrows
37.     public static DocBuilder builder(File file) {
38.         return new DocBuilder().templateInputStream(Files.newInputStream(file.toPath()))
39.                                .wordMLPackage(WordprocessingMLPackage.load(file));
40.     }
42.     @SneakyThrows
43.     public static DocBuilder builder(InputStream inputStream) {
44.         return new DocBuilder().templateInputStream(inputStream)
45.                                .wordMLPackage(WordprocessingMLPackage.load(inputStream));
46.     }
48.     @SneakyThrows
49.     public static DocBuilder builder(String filePath) {
50.         return new DocBuilder().templateInputStream(Files.newInputStream(new File(filePath).toPath()))
51.                                .wordMLPackage(WordprocessingMLPackage.load(new File(filePath)));
52.     }
54.     public static class DocBuilder {
55.         private InputStream templateInputStream;
57.         private WordprocessingMLPackage wordMLPackage;
59.         private XHTMLImporterImpl importer;
61.         private FormattingOption paragraphFormatting;
63.         private FormattingOption runFormatting;
65.         private FormattingOption tableFormatting;
67.         private String staticResourceBaseUri;
69.         private String[] placeHolderPreSuffix = new String[]{"{{", "}}"};
71.         private Configure templateEngineConfigure;
73.         private boolean useHtmlDefaultStyle = true;
75.         private boolean autoCloseStream = true;
77.         private String globalCss = "table{border-collapse:collapse;border-spacing:0;width:100%;margin:1em 0;background-color:transparent;}table th{background-color:#f7f7f7;border:1px solid #ddd;padding:8px 12px;text-align:left}table td{border:1px solid #ddd;padding:8px 12px}";
79.         /**
80.          * <String, String, String>: htmlContent htmlKey resultHtmlContent
81.          */
82.         private BiFunction<String, String, String> htmlContentProcessor;
84.         private DocBuilder templateInputStream(InputStream templateInputStream) {
85.             this.templateInputStream = templateInputStream;
86.             return this;
87.         }
89.         private DocBuilder wordMLPackage(WordprocessingMLPackage wordMLPackage) {
90.             this.wordMLPackage = wordMLPackage;
91.             return this;
92.         }
94.         public DocBuilder importer(XHTMLImporterImpl importer) {
95.             this.importer = importer;
96.             return this;
97.         }
99.         public DocBuilder paragraphFormatting(FormattingOption paragraphFormatting) {
100.             this.paragraphFormatting = paragraphFormatting;
101.             return this;
102.         }
104.         public DocBuilder runFormatting(FormattingOption runFormatting) {
105.             this.runFormatting = runFormatting;
106.             return this;
107.         }
109.         public DocBuilder tableFormatting(FormattingOption tableFormatting) {
110.             this.tableFormatting = tableFormatting;
111.             return this;
112.         }
114.         public DocBuilder useHtmlDefaultStyle(boolean useHtmlDefaultStyle) {
115.             this.useHtmlDefaultStyle = useHtmlDefaultStyle;
116.             return this;
117.         }
119.         public DocBuilder staticResourceBaseUri(String staticResourceBaseUri) {
120.             this.staticResourceBaseUri = staticResourceBaseUri;
121.             return this;
122.         }
124.         public DocBuilder placeHolderPreSuffix(String placeHolderPrefix, String placeHolderSuffix) {
125.             this.placeHolderPreSuffix = new String[]{placeHolderPrefix, placeHolderSuffix};
126.             return this;
127.         }
129.         public DocBuilder templateEngineConfigure(Configure templateEngineConfigure) {
130.             this.templateEngineConfigure = templateEngineConfigure;
131.             return this;
132.         }
134.         public DocBuilder autoCloseStream(boolean autoCloseStream) {
135.             this.autoCloseStream = autoCloseStream;
136.             return this;
137.         }
139.         public DocBuilder globalCss(String globalCss) {
140.             this.globalCss = globalCss;
141.             return this;
142.         }
144.         public DocBuilder htmlContentProcessor(BiFunction<String, String, String> htmlContentProcessor) {
145.             this.htmlContentProcessor = htmlContentProcessor;
146.             return this;
147.         }
149.         public List<Object> buildWordML(String html) {
150.             return this.buildWordML(html, null);
151.         }
153.         public void buildWord(String html, String outputFile) {
154.             this.buildWord(html, new File(outputFile));
155.         }
157.         public void buildWord(String html, File outputFile) {
158.             try {
159.                 this.getMainContent()
160.                     .addAll(this.buildWordML(html));
161.                 wordMLPackage.save(outputFile);
162.             }
163.             catch (Exception e) {
164.                 log.error("failed to build word file", e);
165.                 throw new RuntimeException(e);
166.             }
167.         }
169.         public void buildWord(String html, OutputStream outputStream) {
170.             try {
171.                 this.getMainContent()
172.                     .addAll(this.buildWordML(html));
173.                 wordMLPackage.save(outputStream);
174.             }
175.             catch (Exception e) {
176.                 log.error("failed to build word file", e);
177.                 throw new RuntimeException(e);
178.             }
179.             finally {
180.                 try {
181.                     if (autoCloseStream) {
182.                         outputStream.close();
183.                     }
184.                 }
185.                 catch (IOException ignored) {
186.                 }
187.             }
188.         }
190.         public void buildWord(Map<String, Object> placeHolderData, OutputStream outputStream) {
191.             try {
192.                 // 替换模板中的普通占位符
193.                 if (this.checkPlaceHolderDataType(placeHolderData) == 1) {
194.                     this.replacePlaceHolder(placeHolderData, outputStream);
195.                 }
197.                 // 替换模板中包含的html
198.                 if (this.checkPlaceHolderDataType(placeHolderData) == 2) {
199.                     this.replaceHtmlPlaceHolder(placeHolderData, outputStream);
200.                 }
202.                 // 替换普通/html占位符
203.                 if (this.checkPlaceHolderDataType(placeHolderData) == 3) {
204.                     final File tempDocFile = DocUtils.createTempDocFile();
205.                     this.replaceHtmlPlaceHolder(placeHolderData, tempDocFile);
206.                     this.replacePlaceHolder(placeHolderData, tempDocFile, tempDocFile);
207.                     DocUtils.writeAndDeleteFile(tempDocFile, outputStream);
208.                 }
209.             }
210.             catch (Exception e) {
211.                 log.error("failed to build word file", e);
212.                 throw new RuntimeException(e);
213.             }
214.             finally {
215.                 try {
216.                     if (autoCloseStream) {
217.                         outputStream.close();
218.                     }
219.                 }
220.                 catch (IOException ignored) {
221.                 }
222.             }
223.         }
225.         public void buildWord(Map<String, Object> placeHolderData, File outputFile) {
226.             // 替换模板中的普通占位符
227.             if (this.checkPlaceHolderDataType(placeHolderData) == 1) {
228.                 this.replacePlaceHolder(placeHolderData, outputFile);
229.             }
231.             // 替换模板中包含的html
232.             if (this.checkPlaceHolderDataType(placeHolderData) > 1) {
233.                 this.replaceHtmlPlaceHolder(placeHolderData, outputFile);
234.             }
236.             // 追加替换普通占位符
237.             if (this.checkPlaceHolderDataType(placeHolderData) == 3) {
238.                 this.replacePlaceHolder(placeHolderData, outputFile, outputFile);
239.             }
240.         }
242.         private List<Object> buildWordML(String html, String htmlKey) {
243.             final XHTMLImporterImpl importer = this.getImporterOrDefault();
244.             try {
245.                 if (globalCss != null && !globalCss.isEmpty()) {
246.                     html = DocUtils.addHtmlStyles(html, globalCss);
247.                 }
249.                 if (htmlContentProcessor != null) {
250.                     html = htmlContentProcessor.apply(html, htmlKey);
251.                 }
253.                 return importer.convert(html, staticResourceBaseUri);
254.             }
255.             catch (Exception e) {
256.                 log.error("failed to convert HTML to XHTML", e);
257.                 throw new RuntimeException(e);
258.             }
259.         }
261.         private void replaceHtmlPlaceHolder(Map<String, Object> placeHolderData, File outputFile) {
262.             this.doReplaceHtmlPlaceHolder(placeHolderData);
264.             try {
265.                 // 替换html
266.                 wordMLPackage.save(outputFile);
267.             }
268.             catch (Docx4JException e) {
269.                 log.error("failed to build word file", e);
270.                 throw new RuntimeException(e);
271.             }
272.         }
274.         private void replaceHtmlPlaceHolder(Map<String, Object> placeHolderData, OutputStream outputStream) {
275.             this.doReplaceHtmlPlaceHolder(placeHolderData);
277.             try {
278.                 // 替换html
279.                 wordMLPackage.save(outputStream);
280.             }
281.             catch (Docx4JException e) {
282.                 log.error("failed to build word file", e);
283.                 throw new RuntimeException(e);
284.             }
285.             finally {
286.                 try {
287.                     if (autoCloseStream) {
288.                         outputStream.close();
289.                     }
290.                 }
291.                 catch (IOException ignored) {
292.                 }
293.             }
294.         }
296.         private void doReplaceHtmlPlaceHolder(Map<String, Object> placeHolderData) {
297.             final List<Object> mainContent = this.getMainContent();
298.             List<Object> newContent = new ArrayList<>();
300.             for (Object p : mainContent) {
301.                 String text = DocUtils.extractText(p);
303.                 Optional<String> matchedKey = placeHolderData.keySet()
304.                                                              .stream()
305.                                                              .filter(key -> DocUtils.matchPlaceHolder(text, key, placeHolderPreSuffix[0], placeHolderPreSuffix[1]))
306.                                                              .findFirst();
308.                 if (matchedKey.isPresent()) {
309.                     String key = matchedKey.get();
310.                     Object value = placeHolderData.get(key);
312.                     if (DocUtils.isHtml(value)) {
313.                         final List<Object> wordFragment = this.buildWordML((String) value, key);
314.                         newContent.addAll(wordFragment);
315.                     }
316.                     else {
317.                         newContent.add(p);
318.                     }
319.                 }
320.                 else {
321.                     newContent.add(p);
322.                 }
323.             }
325.             // 替换模板内容
326.             mainContent.clear();
327.             mainContent.addAll(newContent);
328.         }
330.         private void replacePlaceHolder(Map<String, Object> data, File templateFile, File outputFile) {
331.             final Configure templateEngineConfigure = this.getTemplateEngineConfigureOrDefault();
332.             try (XWPFTemplate template = XWPFTemplate.compile(templateFile, templateEngineConfigure)){
333.                 template.render(data)
334.                         .writeToFile(outputFile.getAbsolutePath());
335.             }
336.             catch (IOException e) {
337.                 log.error("failed to replace template word placeholder", e);
338.                 throw new RuntimeException(e);
339.             }
340.         }
342.         public void replacePlaceHolder(Map<String, Object> data, File outputFile) {
343.             final Configure templateEngineConfigure = this.getTemplateEngineConfigureOrDefault();
345.             if (templateInputStream == null) {
346.                 throw new NullPointerException("template file can not be null");
347.             }
349.             XWPFTemplate template = XWPFTemplate.compile(templateInputStream, templateEngineConfigure);
350.             try {
351.                 template.render(data)
352.                         .writeToFile(outputFile.getAbsolutePath());
353.             }
354.             catch (IOException e) {
355.                 log.error("failed to replace template word placeholder", e);
356.                 throw new RuntimeException(e);
357.             }
358.         }
360.         public void replacePlaceHolder(Map<String, Object> data, String outputFileAbsolutePath) {
361.             final Configure templateEngineConfigure = this.getTemplateEngineConfigureOrDefault();
363.             if (templateInputStream == null) {
364.                 throw new NullPointerException("template file can not be null");
365.             }
367.             XWPFTemplate template = XWPFTemplate.compile(templateInputStream, templateEngineConfigure);
368.             try {
369.                 template.render(data)
370.                         .writeToFile(outputFileAbsolutePath);
371.             }
372.             catch (IOException e) {
373.                 log.error("failed to replace template word placeholder", e);
374.                 throw new RuntimeException(e);
375.             }
376.         }
378.         public void replacePlaceHolder(Map<String, Object> data, OutputStream outputStream) {
379.             final Configure templateEngineConfigure = this.getTemplateEngineConfigureOrDefault();
381.             if (templateInputStream == null) {
382.                 throw new NullPointerException("template file can not be null");
383.             }
385.             try {
386.                 XWPFTemplate template = XWPFTemplate.compile(templateInputStream, templateEngineConfigure);
387.                 final XWPFTemplate render = template.render(data);
388.                 render.write(outputStream);
389.             }
390.             catch (IOException e) {
391.                 log.error("failed to replace template word placeholder", e);
392.                 throw new RuntimeException(e);
393.             }
394.             finally {
395.                 try {
396.                     if (autoCloseStream) {
397.                         outputStream.close();
398.                     }
399.                 }
400.                 catch (IOException ignored) {
401.                 }
402.             }
403.         }
405.         private XHTMLImporterImpl getImporterOrDefault() {
406.             if (importer == null) {
407.                 if (paragraphFormatting != null || runFormatting != null || tableFormatting != null) {
408.                     XHTMLImporterImpl importer = new XHTMLImporterImpl(wordMLPackage);
409.                     importer.setParagraphFormatting(paragraphFormatting == null ? FormattingOption.CLASS_PLUS_OTHER : paragraphFormatting);
410.                     importer.setRunFormatting(runFormatting == null ? FormattingOption.CLASS_PLUS_OTHER : runFormatting);
411.                     importer.setTableFormatting(tableFormatting == null ? FormattingOption.CLASS_PLUS_OTHER : tableFormatting);
413.                     return importer;
414.                 }
415.                 else {
416.                     return this.defaultImporter();
417.                 }
418.             }
419.             else {
420.                 return this.importer;
421.             }
422.         }
424.         private Configure getTemplateEngineConfigureOrDefault() {
425.             if (templateEngineConfigure == null) {
426.                 return this.defaultTemplateEngineConfigure();
427.             }
428.             else {
429.                 return this.templateEngineConfigure;
430.             }
431.         }
433.         private Configure defaultTemplateEngineConfigure() {
434.             return Configure.builder()
435.                             .buildGramer(placeHolderPreSuffix[0], placeHolderPreSuffix[1])
436.                             .build();
437.         }
439.         private XHTMLImporterImpl defaultImporter() {
440.             XHTMLImporterImpl importer = new XHTMLImporterImpl(wordMLPackage);
441.             if (useHtmlDefaultStyle) {
442.                 importer.setParagraphFormatting(FormattingOption.CLASS_PLUS_OTHER);
443.                 importer.setRunFormatting(FormattingOption.CLASS_PLUS_OTHER);
444.                 importer.setTableFormatting(FormattingOption.CLASS_PLUS_OTHER);
445.             }
446.             else {
447.                 importer.setParagraphFormatting(FormattingOption.CLASS_TO_STYLE_ONLY);
448.                 importer.setRunFormatting(FormattingOption.CLASS_TO_STYLE_ONLY);
449.                 importer.setTableFormatting(FormattingOption.CLASS_TO_STYLE_ONLY);
450.             }
452.             return importer;
453.         }
455.         private List<Object> getMainContent() {
456.             MainDocumentPart mainDocumentPart = wordMLPackage.getMainDocumentPart();
457.             if (globalCss != null && !globalCss.isEmpty()) {
458.                 mainDocumentPart.getStyleDefinitionsPart()
459.                                 .setCss(globalCss);
460.             }
461.             Body body = mainDocumentPart.getJaxbElement()
462.                                         .getBody();
463.             return body.getContent();
464.         }
466.         /**
467.          * 判断占位符数据类型
468.          *
469.          * @param placeHolderData 占位符数据
470.          * @return 1: 数据不包含html 2: 数据全是html 3: 都包含
471.          */
472.         private int checkPlaceHolderDataType(Map<String, Object> placeHolderData) {
473.             boolean hasHtmlValFlag = false;
474.             boolean hasCommonValFlag = false;
476.             for (Object value : placeHolderData.values()) {
477.                 if (DocUtils.isHtml(value)) {
478.                     hasHtmlValFlag = true;
479.                 }
480.                 else {
481.                     hasCommonValFlag = true;
482.                 }
483.             }
485.             if (!hasHtmlValFlag && hasCommonValFlag) {
486.                 return 1;
487.             }
489.             if (hasHtmlValFlag && !hasCommonValFlag) {
490.                 return 2;
491.             }
493.             return 3;
494.         }
495.     }
496. }

复制代码

8. 测试示例

1. import lombok.SneakyThrows;
2. import org.junit.jupiter.api.BeforeAll;
3. import org.junit.jupiter.api.Test;
5. import java.io.File;
6. import java.io.OutputStream;
7. import java.nio.file.Files;
8. import java.util.HashMap;
9. import java.util.Map;
11. /**
12. * docs test
13. *
14. * @author ludangxin
15. * @since 2025/11/4
16. */
17. public class DocxTest {
18.     private static final File TEMPLATE_FILE = new File("demo.docx");
19.     private static final File OUTPUT_FILE = new File("output.docx");
20.     private static final Map<String, Object> DATA = new HashMap<>();
22.     @BeforeAll
23.     public static void given_data() {
24.         DATA.put("user", "嘉文四世");
25.         DATA.put("summoner", "张铁牛");
26.         DATA.put("position", "打野");
27.         DATA.put("dialogue", "给我找些更强的敌人");
28.         final String markdownContent = "- **背景故事**：嘉文四世是德玛西亚国王嘉文三世的独生子，其母凯瑟琳女士因难产而死。嘉文在宫廷中长大，接受了良好的德玛西亚式教育，并结识了赵信，向其学习战争艺术。他与盖伦年龄相仿，结为好兄弟。嘉文曾率军前往边境对抗诺克萨斯，却因战力分散而战败，幸得希瓦娜相救。后来，德玛西亚国内搜魔人兵团搜捕魔法师引发起义，嘉文三世惨遭弑杀，嘉文四世接掌了议会，之后他登基成为德玛西亚国王。\n" + "\n" + "- **角色定位**：在游戏中，嘉文四世的定位是坦克、战士，他常常需要带头冲入敌方阵地，因此相比输出更加需要增强防御能力。\n" + "\n" + "- 技能介绍\n" + "  ：\n" + "  - **被动技能 - 战争律动**：普攻命中时，会对目标造成 8% 当前生命值的额外物理伤害，该效果作用于同一目标的冷却时间为 6 秒。\n" + "  - **一技能 - 巨龙撞击**：用长矛穿透路径上的敌人，对其造成物理伤害，并减少其护甲，持续 3 秒。若长矛触及 “德邦军旗”，嘉文四世会被引向军旗，并击飞沿途敌人 0.75 秒。\n" + "  - **二技能 - 黄金圣盾**：释放出一道帝王光环，使周围敌人减速，持续 2 秒，同时提供一个可以吸收伤害的护盾，持续 5 秒，附近每多一名敌方英雄，吸收伤害增加。\n" + "  - **三技能 - 德邦军旗**：投掷一柄军旗，对敌人造成魔法伤害，并将军旗置于原地 8 秒，使附近队友获得攻击速度加成。在 “德邦军旗” 附近再次点击施放该技能，将会朝军旗施放 “巨龙撞击”。\n" + "  - **终极技能 - 天崩地裂**：跃向敌方英雄，对目标及其附近的敌人造成物理伤害，并在目标周围形成环形障碍，持续 3.5 秒，再次点击施放可使障碍倒塌。\n" + "\n" + "- **皮肤信息**：嘉文四世拥有多款皮肤，包括孤胆英豪、暗星、福牛守护者等。";
29.         // markdown 2 html (上一章博客的内容)
30.         final String htmlContent = Markdowns.builder(markdownContent)
31.                                             .buildHtmlContent();
32.         DATA.put("description", htmlContent);
33.     }
35.     @Test
36.     public void given_template_doc_and_content_when_replace_then_complete() {
37.         Docs.builder(TEMPLATE_FILE).buildWord(DATA, OUTPUT_FILE);
38.     }
40.     @Test
41.     @SneakyThrows
42.     public void given_template_doc_and_content_when_replace_and_output_stream_then_complete() {
43.         final OutputStream fileOutputStream = Files.newOutputStream(OUTPUT_FILE.toPath());
44.         // 接收输出流
45.         Docs.builder(TEMPLATE_FILE).autoCloseStream(true).buildWord(DATA, fileOutputStream);
46.     }
47. }

复制代码

模板内容如下:

测试效果如下:

9. 小结

本章使用docx4j和poi-tl实现将平凡占位符内容和html文本内容转换为word, 并先容了怎样使用其特性实现自界说样式渲染, 末了封装链式调用的工具类和对应的单元测试代码, 联合上一章内容可以或许将各种情势的内容通过一行代码即可实现word的渲染
10. 源码

测试过程中的代码已全部上传至github, 接待点赞收藏 堆栈所在: https://github.com/ludangxin/markdown2docx