如何使用Java POI在DOCX中创建带TOC的多级列表

嘿，这个需求其实不难搞定，核心是用Markdown的多级标题对应你要的层级结构，再配合工具或Word本身的设置，就能生成带指定编号和目录（TOC）的DOCX文档。下面给你两种常用的实现方式：

方案一：用Pandoc自动化转换（推荐） #

Pandoc是处理Markdown转各种格式的神器，能帮你一键搞定编号和目录，步骤如下：

1. 编写Markdown源文件
   用#表示一级主题，##表示二级条目，结构如下（保存为document.md）：

   # Subject 01
   ## Item 01
   ## Item 02
   
   # Subject 02
   ## Item 03
   ## Item 04
   

   如果需要自动生成目录，直接在文件开头加上[TOC]即可。

2. 自定义DOCX模板（设置编号格式）
   Pandoc默认的DOCX模板可能不符合你的编号要求，所以我们先导出默认模板并修改：

   • 执行命令导出默认模板：

     pandoc -o custom-template.docx --print-default-data-file reference.docx
     

   • 打开导出的custom-template.docx，在Word里修改样式：
     • 找到「标题1」样式，右键选择「修改」，设置编号格式为1.，编号样式选阿拉伯数字，起始编号设为1；
     • 找到「标题2」样式，右键「修改」，设置编号格式为1.1.，并设置编号链接到上一级（标题1），调整好缩进让格式更美观；
     • 保存修改后的模板文件。

3. 转换生成DOCX
   执行以下命令，用自定义模板转换Markdown文件，同时生成目录：

   pandoc document.md -o output.docx --reference-doc=custom-template.docx --toc
   

   生成的output.docx就会自动带上你要的编号格式，同时包含自动生成的目录啦。

方案二：直接用Word导入Markdown（无需额外工具） #

如果不想装Pandoc，直接用Word也能实现：

1. 导入Markdown文件到Word
   打开Word，点击「文件」>「打开」，找到你的Markdown文件，Word会自动识别并把#转为「标题1」样式，##转为「标题2」样式。

2. 设置多级编号

   • 选中所有「标题1」内容，在「开始」选项卡的「段落」组里，点击「多级列表」>「定义新的多级列表」；
   • 针对第一级（对应标题1）：设置编号格式为1.，编号样式选阿拉伯数字，把「将级别链接到样式」设为「标题1」；
   • 针对第二级（对应标题2）：设置编号格式为1.1.，编号样式选阿拉伯数字，「将级别链接到样式」设为「标题2」，并调整缩进让层级更清晰；
   • 确认设置后，所有标题就会自动带上你要的编号了。

3. 插入目录（TOC）
   把光标移到你想放目录的位置，点击「引用」选项卡>「目录」>「自定义目录」，勾选「显示页码」「页码右对齐」，选择合适的格式，确认后就能生成自动更新的目录了。

内容的提问来源于stack exchange，提问作者Jose Miguel Boeres Filho