如何用Pandoc保留Markdown嵌套Definition List的DOCX输出结构？

核心原因 #

Pandoc默认的DOCX模板对嵌套定义列表的样式支持不完善，仅为顶层定义项分配了「Definition Term」和「Definition」样式，嵌套层级的项没有对应的关联样式，导致缩进丢失。

可行解决方案 #

1. 自定义DOCX模板的多级样式 #

• 先导出Pandoc默认的DOCX模板：

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

• 用Word打开这个模板，创建多级样式：
  • 复制「Definition Term」样式，命名为「Definition Term 2」「Definition Term 3」等，分别设置不同的缩进值（比如每级增加0.5英寸）
  • 同理复制「Definition」样式，创建「Definition 2」「Definition 3」等，对应嵌套层级的定义内容，设置匹配的缩进
• 保存修改后的模板，转换时指定模板：

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

2. 用Markdown列表嵌套模拟定义列表 #

如果自定义模板太繁琐，可以把嵌套定义列表改成列表嵌套+粗体术语的形式，让Pandoc能识别层级：

- **Term 1**: Definition 1
  - **Term 1a**: Definition 1a
    - **Term 1a1**: Definition 1a1
  - **Term 1b**: Definition 1b

这种结构Pandoc转DOCX时会保留列表的嵌套缩进，虽然不是原生定义列表格式，但能保证层级结构正确。

3. 使用Pandoc的Lua过滤器处理嵌套定义项 #

编写简单的Lua过滤器，自动为嵌套层级的定义术语和内容分配对应的自定义样式：

• 创建nested-defs.lua文件，内容如下：

  local level = 0
  
  function DefinitionList(el)
    level = level + 1
    for _, item in ipairs(el.content) do
      -- 为术语分配对应层级的样式
      item.term[1] = pandoc.Span(item.term[1], {custom_style = "Definition Term " .. level})
      -- 为定义内容分配对应层级的样式
      for _, def in ipairs(item.definitions) do
        for _, block in ipairs(def.content) do
          block.attributes.custom_style = "Definition " .. level
        end
      end
    end
    level = level - 1
    return el
  end
  

• 转换时加载过滤器：

  pandoc input.md -o output.docx --reference-doc=custom-template.docx --lua-filter=nested-defs.lua
  

  注意：此方法需要提前在模板中创建好对应层级的「Definition Term N」和「Definition N」样式。

注意事项 #

• 修改DOCX模板时，确保样式的「缩进」和「段落间距」设置正确，避免层级混乱
• 使用Lua过滤器时，要保证Markdown中的定义列表嵌套格式正确（每级术语前增加对应数量的缩进）

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