RMarkdown转docx：双图带引用和上标的标题无法正常显示

问题根源 #

Bookdown生成PDF时靠LaTeX解析^上标，但生成DOCX时，多图场景（比如一次插入多张图、用fig.show='hold'排版）的标题解析逻辑和单图不一样，^会被当成普通文本甚至过滤，导致上标消失；单图标题因为解析路径特殊，所以能正常生效。

实用解决方案 #

1. 改用Pandoc原生上标语法（推荐）

把原来标题里的^内容改成^[内容]，这个语法能被Pandoc同时解析为PDF和DOCX的上标，示例代码：

# 插入两张图，标题带上下标
knitr::include_graphics(
  c("plot_a.png", "plot_b.png"),
  fig.cap = "图A^[1]和图B^[2]的对比分析（多图示例）"
)

这个方法最省心，不影响PDF渲染，DOCX里的上标也能正常显示。

2. 直接用OpenXML代码（复杂场景）

如果需要更复杂的上标格式（比如带格式的上标文本），可以直接嵌入DOCX支持的OpenXML代码，示例：

knitr::include_graphics(
  c("plot_a.png", "plot_b.png"),
  fig.cap = "图A{=openxml}<w:r><w:rPr><w:vertAlign w:val=\"superscript\"/></w:rPr><w:t>1</w:t></w:r>和图B{=openxml}<w:r><w:rPr><w:vertAlign w:val=\"superscript\"/></w:rPr><w:t>2</w:t></w:r>的对比"
)

这种方式完全适配DOCX格式，但可读性差，只适合特殊需求。

3. 自定义DOCX模板（批量处理）

如果需要统一管理所有标题的上标样式，可以修改DOCX输出模板：

• 导出默认模板：rmarkdown::draft("custom_template.docx", template = "default", package = "rmarkdown")
• 用Word打开模板，设置「标题」样式的上标规则，或者新建一个「上标文本」的自定义样式
• 在RMarkdown的YAML里指定模板：

  output:
    bookdown::word_document2:
      template: custom_template.docx
  

• 标题里用*[上标文本]{内容}调用自定义样式实现上标

验证步骤 #

修改后重新渲染，先检查DOCX的多图标题上标是否正常，再确认PDF渲染不受影响，确保两种格式兼容。

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