基于Java的Markdown转Word工具（标题、段落、表格、Echarts图等）

项目源于我们开发的一款基于大模型的报告生成工具。由于需要将 Markdown 格式的内容导出为 Word 文档，而市面上缺乏合适的现成工具，所以决定自己开发一个Markdown转Word的工具。

🩷源码地址：daydayup-zyn/md2doc-plus

😀实现思路

md2doc-plus 基于 Java 17 和 Apache POI 构建，采用模块化设计，主要包括以下几个核心组件：

Markdown 解析器：负责解析 Markdown 内容，识别文本、表格、图表等元素
文档生成器：使用 Apache POI 创建和操作 Word 文档
模板引擎：支持动态生成文档模板，便于后续内容替换
图表转换器：专门处理 ECharts 图表到 Word 图表的转换

😃核心转换流程如下：

解析 Markdown 内容，识别各种元素（标题、段落、表格、图表等）
基于 Markdown 结构，自动化创建 Word 文档模板，为动态内容预留占位符
将解析后的内容填充到模板中
生成最终的 Word 文档

😁功能亮点

动态word模板生成

系统能够根据 Markdown 内容结构动态生成 Word 模板，为后续内容填充预留占位符。

Markdown 各级标题与段落文本支持

完整支持 Markdown 的六级标题（H1-H6）以及普通段落文本的转换。系统会自动识别标题级别，并应用相应的格式化样式，包括字体大小、加粗等属性。

Markdown 表格转换

能够准确解析并转换 Markdown 表格语法，将表格内容转换为 Word 中的表格对象，保持原有的行列结构和数据内容。

ECharts图表集成

支持将 Markdown 中的 ECharts 图表配置代码块转换为 Word 中的图表对象，包括自动识别 ECharts 代码块、解析 ECharts 配置并提取图表数据、在 Word 文档中生成对应的图表对象、支持多种图表类型（柱状图、折线图、饼图等）。

{title: {text: '月度销售数据1'},tooltip: {trigger: 'axis'},xAxis: {type: 'category',data: ['1月', '2月', '3月', '4月', '5月', '6月']},yAxis: {type: 'value',name: '销售额'},series: [{name: '销售额',type: 'line',data: [15.32, 15.87, 14.96, 16.23, 13.21, 13.53]}]
}

章节标题自动添加序号、标题格式

具备自动化标题编号功能，能够根据标题层级自动为章节标题添加序号（如 1.1、1.2、2.1 等），并应用标准的标题样式。这使得生成的 Word 文档可以直接用于创建目录，极大地提升了文档的专业性和可用性。

🫠核心实现代码解析

Markdown 解析与文档结构创建
md2doc-plus 的核心功能之一是解析 Markdown 内容并创建相应的 Word 文档结构。这主要在 DynamicWordDocumentCreator 类中实现：

/*** 解析Markdown内容并创建Word文档结构* @param document Word文档对象* @param markdownContent Markdown内容*/
private static void parseAndCreateDocumentStructure(XWPFDocument document, String markdownContent) {// 用于匹配ECharts代码块的正则表达式Pattern echartsPattern = Pattern.compile("‍```echarts\\s*\\n(.*?)\\n‍```", Pattern.DOTALL);// 用于匹配表格的正则表达式Pattern tablePattern = Pattern.compile("(\\|[^\\n]*\\|\\s*\\n\\s*\\|[-|\\s]*\\|\\s*\\n(?:\\s*\\|[^\\n]*\\|\\s*\\n?)*)", Pattern.MULTILINE);// 用于匹配标题的正则表达式Pattern headerPattern = Pattern.compile("^(#{1,6})\\s+(.*)$", Pattern.MULTILINE);String[] lines = markdownContent.split("\n");int chartIndex = 1;int tableIndex = 1;for (int i = 0; i < lines.length; i++) {String line = lines[i];// 检查是否为标题Matcher headerMatcher = headerPattern.matcher(line);if (headerMatcher.find()) {int level = headerMatcher.group(1).length();String title = headerMatcher.group(2);XWPFParagraph headerParagraph = document.createParagraph();setHeaderStyle(headerParagraph, level);setHeaderParagraphStyle(headerParagraph, level);XWPFRun headerRun = headerParagraph.createRun();headerRun.setText(title);headerRun.setBold(true);headerRun.setFontFamily("宋体");// 根据标题级别设置字体大小int fontSize = 16; // 默认H3switch (level) {case 1: fontSize = 22; break; // H1case 2: fontSize = 20; break; // H2case 3: fontSize = 18; break; // H3case 4: fontSize = 16; break; // H4case 5: fontSize = 14; break; // H5case 6: fontSize = 12; break; // H6}headerRun.setFontSize(fontSize);continue;}// 检查是否为ECharts图表if (line.trim().equals("‍```echarts")) {// 查找图表代码块的结束位置StringBuilder chartCode = new StringBuilder();i++; // 移动到下一行while (i < lines.length && !lines[i].trim().equals("‍```")) {chartCode.append(lines[i]).append("\n");i++;}// 创建图表占位符XWPFParagraph chartTitleParagraph = document.createParagraph();setDefaultParagraphStyle(chartTitleParagraph); // 图表标题使用默认段落样式XWPFRun chartTitleRun = chartTitleParagraph.createRun();chartTitleRun.setText("图表 " + chartIndex + "：");chartTitleRun.setBold(true);chartTitleRun.setFontFamily("宋体");// 创建实际的图表对象try {createChartInDocument(document, "chart" + chartIndex, chartCode.toString());} catch (Exception e) {// 如果创建图表失败，至少添加占位符XWPFParagraph chartParagraph = document.createParagraph();chartParagraph.setAlignment(ParagraphAlignment.CENTER);setDefaultParagraphStyle(chartParagraph);XWPFRun chartRun = chartParagraph.createRun();chartRun.setText("${chart" + chartIndex + "}");}chartIndex++;continue;}// 检查是否为表格开始if (line.startsWith("|")) {// 收集表格的所有行StringBuilder tableMarkdown = new StringBuilder(line).append("\n");i++; // 移动到下一行while (i < lines.length && (lines[i].startsWith("|") || lines[i].trim().matches("^\\|?\\s*[-|:\\s]+\\|?\\s*$"))) {tableMarkdown.append(lines[i]).append("\n");i++;}i--; // 回退一行，因为循环会自动增加i// 创建表格占位符XWPFParagraph tableTitleParagraph = document.createParagraph();setDefaultParagraphStyle(tableTitleParagraph); // 表格标题使用默认段落样式XWPFRun tableTitleRun = tableTitleParagraph.createRun();tableTitleRun.setText("表格 " + tableIndex + "：");tableTitleRun.setBold(true);tableTitleRun.setFontFamily("宋体");XWPFParagraph tableParagraph = document.createParagraph();setDefaultParagraphStyle(tableParagraph);XWPFRun tableRun = tableParagraph.createRun();tableRun.setText("${table" + tableIndex + "}");tableIndex++;continue;}// 普通段落if (!line.trim().isEmpty()) {XWPFParagraph paragraph = document.createParagraph();setDefaultParagraphStyle(paragraph); // 内容段落使用默认样式XWPFRun run = paragraph.createRun();run.setText(line);run.setFontFamily("宋体");run.setFontSize(12); // 小四号字体}}
}

ECharts 图表转换
EChartsToWordConverter 类负责将 ECharts 配置转换为 Word 图表数据：

public static void convertEChartsToWordChart(WordParams params, String chartKey, String echartsConfig) throws IOException {try {// 预处理ECharts配置，将其转换为有效的JSON格式String jsonConfig = convertEChartsToJson(echartsConfig);JsonNode rootNode = objectMapper.readTree(jsonConfig);// 获取图表标题String title = rootNode.path("title").path("text").asText("默认标题");// 创建图表ChartTable chartTable = params.addChart(chartKey).setTitle(title);// 处理 X 轴数据JsonNode xAxisNode = rootNode.path("xAxis");if (xAxisNode.isArray()) {xAxisNode = xAxisNode.get(0); // 多个 x 轴时取第一个}if (!xAxisNode.isMissingNode()) {JsonNode xAxisData = xAxisNode.path("data");if (!xAxisData.isMissingNode()) {List<String> xAxisLabels = new ArrayList<>();for (JsonNode dataNode : xAxisData) {xAxisLabels.add(dataNode.asText());}chartTable.getXAxis().addAllData(xAxisLabels);}}// 处理 Y 轴数据和系列数据JsonNode seriesNode = rootNode.path("series");if (seriesNode.isArray()) {for (JsonNode serie : seriesNode) {String seriesName = serie.path("name").asText("数据系列");JsonNode seriesData = serie.path("data");if (!seriesData.isMissingNode() && seriesData.isArray()) {List<Number> dataValues = new ArrayList<>();for (JsonNode dataNode : seriesData) {if (dataNode.isNumber()) {dataValues.add(dataNode.numberValue());} else {dataValues.add(0);}}chartTable.newYAxis(seriesName).addAllData(dataValues);}}}// 如果有 Y 轴名称设置，更新第一个 Y 轴的标题JsonNode yAxisNode = rootNode.path("yAxis");if (yAxisNode.isArray()) {yAxisNode = yAxisNode.get(0); // 多个 y 轴时取第一个}if (!yAxisNode.isMissingNode()) {String yAxisName = yAxisNode.path("name").asText("");if (!yAxisName.isEmpty() && !chartTable.getYAxis().isEmpty()) {// 获取第一个 Y 轴并设置标题String firstKey = chartTable.getYAxis().keySet().iterator().next();chartTable.getYAxis(firstKey).setTitle(yAxisName);}}} catch (Exception e) {// 如果解析失败，创建一个默认的空图表ChartTable chartTable = params.addChart(chartKey).setTitle("默认图表标题");chartTable.getXAxis().addAllData("数据1", "数据2", "数据3");chartTable.newYAxis("默认系列").addAllData(10, 20, 30);throw new IOException("解析ECharts配置时出错: " + e.getMessage(), e);}
}

表格解析
MarkdownTableParser 类负责解析 Markdown 表格：

public static List<List<String>> parseTable(String markdownTable) {List<List<String>> tableData = new ArrayList<>();String[] lines = markdownTable.split("\n");for (String line : lines) {line = line.trim();// 跳过分隔行（只包含|和-的行）if (line.matches("^\\|?\\s*[-|:\\s]+\\|?\\s*$") && line.contains("-")) {continue;}if (line.startsWith("|")) {line = line.substring(1);}if (line.endsWith("|")) {line = line.substring(0, line.length() - 1);}String[] cells = line.split("\\|");List<String> row = new ArrayList<>();for (String cell : cells) {row.add(cell.trim());}// 只有当行不为空时才添加到表格数据中if (!row.isEmpty() && !(row.size() == 1 && row.get(0).isEmpty())) {tableData.add(row);}}return tableData;
}

🥰使用示例

使用 md2doc-plus 非常简单，只需要几行代码：

public class Test {public static void main(String[] args) throws Exception {MarkdownToWordConverter.convertMarkdownFileToWord("./markdown/未命名.md","./word/未命名_output.docx");}
}