RMarkdown knit导出PDF时多行公式交叉引用失效问题咨询

• 输出格式优先级错配：当前YAML把基础pdf_document: default放在了bookdown::pdf_document2前面，RMarkdown编译时会优先取列表最上方的格式作为编译目标，等于实际运行的是没有交叉引用扩展的基础rmarkdown PDF流程，根本不会解析bookdown专属的标签语法——既认不出(\#eq:xxx)是交叉引用锚点，也不会把这些标记从公式内容里剥离，自然会出现标签直接露在公式里、@ref(eq:xxx)引用失效的问题。
• 公式标签的放置位置不对：你把交叉引用标签和最后一行公式写在了同一行，bookdown对align环境的标签识别要求是，标签必须单独成行，不能嵌在公式表达式的内容行里，不然会被当成普通公式文本渲染出来。

1. 修正YAML头部配置 #

把带交叉引用能力的bookdown输出格式调到输出列表的最前面，删掉没必要的基础格式条目，修正后的配置如下：

---
title: "Cross-referencing figures, tables, and equations"
author: "Generated by bookdown"
output:
  bookdown::pdf_document2: default
  bookdown::html_document2: default
---

注意：如果需要同时保留基础pdf_document的输出选项，必须把它挪到输出列表的最后，保证bookdown的扩展格式是默认编译目标。基础rmarkdown本身不支持bookdown的交叉引用语法，在基础格式下写标签必然会直接显示为可见文本，这是格式本身的能力边界，不是配置错误。

2. 调整多行公式的书写格式 #

把交叉引用标签单独放一行，不要和公式内容挤在同一行，正确的align环境写法如下：

\begin{align} 
g(X_{n}) &= g(\theta)+g'(\tilde{\theta})(X_{n}-\theta) \notag \\
\sqrt{n}[g(X_{n})-g(\theta)] &= g'\left({\tilde{\theta}}\right)
  \sqrt{n}[X_{n}-\theta ]
  (\#eq:align)
\end{align}

细节提醒：标签行不要加换行用的反斜杠，不要紧邻上一行公式书写。bookdown会自动识别独立成行的标签，替换成对应位置的公式编号，不会在页面上显示原始的(\#eq:xxx)文本。

3. 交叉引用的使用 #

配置调整完成后，在正文里直接写@ref(eq:align)，编译后会自动替换为对应的公式编号，PDF和HTML输出下都能正常跳转，不会出现引用失效的问题。

• 不要把标签直接拼在公式行末尾：比如写成\sqrt{n}[X_{n}-\theta ] (\#eq:align) \\的形式，标签会被绑定到当前行的公式上，而且因为和公式内容紧邻，很容易出现解析异常。
• 不要给标签加多余转义：比如把(\#eq:align)写成(\\#eq:align)，多余的反斜杠会让bookdown识别不到锚点，直接把标记显示出来。
• 排查编译逻辑的小技巧：如果调整完配置还是出现标签外露的问题，可以在knit完成后查看生成的临时.tex文件，找到对应公式块的位置，如果能看到原始的(\#eq:align)文本没有被替换，就说明实际编译没走bookdown的渲染流程，回去检查YAML里输出格式的优先级即可。

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