R Markdown脚注上标跳转至首页无法定位对应脚注问题问询

故障原因 #

• 最常见原因是rmarkdown包版本过低，或是使用的输出模板没有正确渲染脚注双向锚点，导致上标引用的锚点和底部脚注的锚点无法匹配，点击后默认跳转至页面顶部
• 如果配置了全局baseURL参数，脚注的相对路径锚点会被定向到根路径，也就是首页
• 使用多页输出的bookdown格式时，脚注引用和脚注内容被拆分到不同页面，跨页锚点无法命中也会触发该问题

修复方法 #

• 先升级rmarkdown包到最新版本，运行命令：install.packages("rmarkdown")
• 普通单页HTML输出的场景，在文档YAML头部显式开启脚注支持，配置参考：

output:
  html_document:
    footnotes: true

• 如果你使用了自定义HTML模板，不要手动删除pandoc自动生成的id="fn*"、id="fnref*"类属性，这类属性是锚点跳转的核心标识
• 多页bookdown输出的场景，将脚注和对应引用放在同一个拆分单元内，或是设置split_by: none输出单页文档即可解决跨页锚点失效问题
• 你当前使用的内联脚注语法本身符合规范，不需要修改语法书写方式

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