使用officedown::rdocx_document生成目录为何丢失章节编号？

可能原因 #

• 自定义模板的标题样式未正确绑定编号：officedown生成目录时依赖Word样式本身的编号属性，而经典word_document可能会自动补充编号逻辑。若你的模板中标题仅手动添加了数字（而非将编号规则绑定到样式），officedown无法识别并在目录中显示。
• 样式兼容性差异：rdocx_document对模板样式的解析逻辑和word_document存在区别，自定义模板的样式设置可能不符合officedown的预期要求。
• YAML配置缺失：officedown需要在输出配置中显式开启章节编号，而word_document默认启用了相关设置。

排查步骤 #

1. 检查模板样式设置：打开自定义style.docx，进入「样式」面板，右键点击标题样式（如标题1、标题2）→「修改」，确认「格式」中的编号是绑定到样式的自动编号（而非手动输入的数字）。
2. 参考officedown默认模板：导出默认模板对比样式配置：

   file.copy(officedown::rdocx_document$default_template(), "default_officedown.docx")
   

   打开该模板查看标题样式的编号规则，与自定义模板对比差异。
3. 完善YAML配置：在Rmd的头部明确指定章节编号和目录参数：

   output:
     officedown::rdocx_document:
       reference_docx: style.docx
       toc: true
       toc_depth: 3
       number_sections: true
   

4. 最小化测试：创建仅包含标题和目录的极简Rmd文件，搭配仅设置带编号标题样式的极简模板，验证问题是否依然存在，排除复杂内容干扰。

是否提交GitHub Issue？ #

若完成上述排查后，确认模板样式配置正确且最小化测试仍复现问题，说明可能是officedown的bug或未明确的模板要求，此时建议提交Issue。提交时需包含：

• 可复现的极简Rmd代码
• 对应的自定义模板文件
• 两种输出格式的目录截图
• 你的R版本、officedown版本及Word版本信息

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