R Markdown补充表格与正文表格交叉引用链接失效问题排查

我在R Markdown文档中用以下LaTeX命令创建补充表格：

\newcommand{\beginsupplement}{\setcounter{table}{0}  \renewcommand{\thetable}{S\arabic{table}} \setcounter{figure}{0} \renewcommand{\thefigure}{S\arabic{figure}}}

但点击正文中的“Table S1”交叉引用时，会跳转到主文档的Table 1，而非对应的补充表格。以下是复现问题的示例代码：

---
title: 'Test Rmd document'
output:
  pdf_document
header-includes: 
- \newcommand{\beginsupplement}{\setcounter{table}{0}  \renewcommand{\thetable}{S\arabic{table}} \setcounter{figure}{0} \renewcommand{\thefigure}{S\arabic{figure}}}
---

{r, setup, include=FALSE}
knitr::opts_chunk$set(echo = FALSE)

library(kableExtra)
library(tibble)

## Main body
This is a main text table (\autoref{main_table}). There is also a supplementary table (\autoref{supplementary_table}).

{r}
table <- tibble(a = 1:3, b = 4:6)
kable(table, 
      caption = "Main body table \\label{main_table}",
        format = "markdown")

\newpage
# Supplementary materials
\beginsupplement

{r}
table <- tibble(a = 7:9, b = 10:12)
kable(table, 
      caption = "Supplementary table \\label{supplementary_table}",
        format = "markdown")

为什么渲染后的PDF里，点击“(Table S1)”会跳转到Table 1？

原因分析 #

问题出在LaTeX交叉引用的底层逻辑：交叉引用的锚点是基于计数器的内部数值，而非显示的编号文本。

你当前的\beginsupplement命令只是把table计数器重置为0，并修改了编号显示格式为S\arabic{table}，但没有创建独立的补充表格计数器。这意味着补充表格的table计数器数值还是1（和主文档的Table 1完全一致），LaTeX生成的锚点名称（比如table.1）会重复，点击引用时会默认跳转到第一个出现的同名锚点，也就是主文档的Table 1。

解决方案 #

方案1：创建独立的补充表格计数器 #

修改header-includes中的LaTeX命令，为补充表格单独创建计数器，避免和主文档的table计数器冲突：

\newcommand{\beginsupplement}{
  % 创建独立的补充表格计数器
  \newcounter{supptable}
  % 修改表格编号显示为S+补充计数器数值
  \renewcommand{\thetable}{S\arabic{supptable}}
  % 确保\autoref识别为Table
  \renewcommand{\tableautorefname}{Table}
  % 重置图片计数器并修改显示格式
  \setcounter{figure}{0}
  \renewcommand{\thefigure}{S\arabic{figure}}
}

同时，将补充表格的代码改为使用LaTeX格式输出，并手动更新补充计数器：

{r}
table <- tibble(a = 7:9, b = 10:12)
# 手动更新补充表格计数器
cat("\\refstepcounter{supptable}\n")
kable(table, 
      caption = "Supplementary table",
      format = "latex",
      label = "supplementary_table") %>%
  kable_styling()

方案2：直接使用LaTeX表格格式输出 #

放弃Markdown格式的表格，直接让kable输出LaTeX格式，并配合重置后的计数器（此方案无需新增计数器，需确保LaTeX能正确识别编号序列）：
修改补充表格的代码块：

{r}
table <- tibble(a = 7:9, b = 10:12)
kable(table, 
      caption = "Supplementary table",
      format = "latex",
      label = "supplementary_table") %>%
  kable_styling()

该方案下，\beginsupplement命令可保留原格式，但需确保渲染时LaTeX会为补充表格生成独立的锚点（部分情况下需多编译一次文档）。

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