使用pagedown::chrome_print()生成PDF时内部链接跳转错误问题

问题详情 #

我正在使用pagedown::chrome_print()将R Markdown渲染为PDF，最近发现PDF中的内部链接出现异常：文档首页的目录链接点击后，会跳转到对应章节所在页面的下一页。

生成PDF的代码如下：

pagedown::chrome_print("section-links.Rmd")

用于复现问题的极简R Markdown示例：

---
title: "Sections with Links"
output: pagedown::html_paged
---

- [About](#about)
- [Introduction](#introduction)
- [Methods](#methods)
- [Analysis](#analysis)
- [Conclusion](#conclusion)

\newpage

## About

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

\newpage

## Introduction

Morbi elementum a erat egestas condimentum.

\newpage

## Methods

Vestibulum at fringilla nisl.

\newpage

## Analysis

Curabitur condimentum eros dui, tempor malesuada lacus interdum sed.

\newpage

## Conclusion

Aenean vestibulum diam justo, in porta nunc pretium sed.

点击“Introduction”链接时，目录高亮显示正确的第3页，但实际跳转到第4页（目标章节的下一页），所有内部链接均存在此问题。转换过程中生成的HTML文件链接正常，推测问题出在HTML转PDF的环节。

经排查，该问题存在于Chrome和Chromium的最新稳定版本：

• ❌ Chromium 126.0.6478.126
• ❌ Google Chrome 126.0.6478.126
  旧版本无此问题：
• ✅ Google Chrome 125.0.6422.60
• ✅ Google Chrome 108.0.5359.71

解决办法 #

方案1：调整chrome_print的PDF生成参数 #

尝试在chrome_print()中添加打印相关参数，修正锚点跳转逻辑：

pagedown::chrome_print(
  "section-links.Rmd",
  extra_args = c("--no-pdf-header-footer", "--disable-print-preview")
)

方案2：用CSS修正锚点位置 #

在R Markdown中添加自定义CSS，调整章节标题的锚点偏移，抵消Chrome新版本的跳转偏差：

/* 可直接添加到R Markdown的YAML头部或单独CSS文件 */
h2 {
  position: relative;
  top: 0;
}
.section-anchor {
  position: absolute;
  top: -1px;
}

方案3：临时指定旧版Chrome路径 #

如果上述方案无效，可在chrome_print()中指定旧版本Chrome的可执行文件路径，强制使用无问题的版本：

pagedown::chrome_print(
  "section-links.Rmd",
  chrome_path = "path/to/your/old/chrome/executable"
)

方案4：等待pagedown版本更新 #

该问题属于Chrome新版本打印逻辑变化导致的兼容性问题，pagedown开发者可能会在后续版本中修复，可关注pagedown的更新日志。

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