本文介绍一种轻量、可靠的方法，通过引入外部 JavaScript 脚本，自动为 Bookdown 生成的 HTML 中所有代码块（）内的超链接添加 target="_blank" 属性，确保用户点击时在新标签页中打开，提升阅读与跳转体验。

本文介绍一种轻量、可靠的方法，通过引入外部 javascript 脚本，自动为 bookdown 生成的 html 中所有代码块（``）内的超链接添加 `target="_blank"` 属性，确保用户点击时在新标签页中打开，提升阅读与跳转体验。

在使用 bookdown::bs4_book 构建 R 文档（如技术手册或教学书籍）时，R 包名、函数名等常被自动渲染为指向 CRAN、rdrr.io 或 GitHub 的可点击超链接——但默认均在当前窗口跳转，易打断读者阅读流程。遗憾的是，Bookdown 和 knitr 并未提供原生选项来控制代码块内链接的 target 属性。

所幸，这一需求可通过前端脚本优雅解决。推荐使用 Yihui Xie 维护的轻量工具库 @xiee/utils 中的 external-link.min.js：它专为 R Markdown/Bookdown 场景设计，仅作用于 <code> 元素内部的 <a></a> 标签（避免误改正文链接），并自动添加 target="_blank" 与 rel="noopener noreferrer"（符合安全最佳实践）。

✅ 实施步骤

1. 创建注入脚本文件
   在项目根目录下新建 includes/after_body.html（路径可自定义，需与配置一致），内容如下：

   <script src="https://cdn.jsdelivr.net/npm/@xiee/utils/js/external-link.min.js" defer></script>

2. 配置 Bookdown 输出格式
   修改 _output.yml（或 _bookdown.yml 中的 output: 部分），启用 includes.after_body：

   output:
     bookdown::bs4_book:
       includes:
         after_body: "includes/after_body.html"

3. 重新渲染书籍
   运行 bookdown::render_book() 或点击 RStudio 中的 “Knit” 按钮即可生效。

? 效果验证

渲染后的 HTML 中，原代码块：

<code class="sourceCode R">
  <span class="kw"><a href="https://rdrr.io/r/base/library.html">library</a></span>
  <span class="op">(</span>
  <span class="va"><a href="https://github.com/duncanplee/CARBayes">CARBayes</a></span>
  <span class="op">)</span>
</code>

将自动变为：

<code class="sourceCode R">
  <span class="kw"><a href="https://rdrr.io/r/base/library.html" target="_blank" rel="noopener noreferrer">library</a></span>
  <span class="op">(</span>
  <span class="va"><a href="https://github.com/duncanplee/CARBayes" target="_blank" rel="noopener noreferrer">CARBayes</a></span>
  <span class="op">)</span>
</code>

⚠️ 注意事项

• 该脚本仅处理已渲染完成的 DOM，无需修改 R Markdown 源码，完全解耦；
• defer 属性确保脚本在 HTML 解析完成后执行，避免因 DOM 未就绪导致失效；
• 若需离线部署，可下载 external-link.min.js 至本地 www/js/ 目录，并改为相对路径引用；
• 不建议手动向代码块插入 HTML（如 <a target="_blank"></a>），因 knitr 会转义或破坏语法高亮。

此方案简洁、健壮、零侵入，是 Bookdown 生态中处理代码内链接行为的事实标准做法。