如何修改RMarkdown生成PDF文件时代码块的背景颜色及格式设置

RMarkdown生成PDF依赖LaTeX渲染，无法直接复用HTML的class样式参数，可通过以下步骤实现等效效果：

步骤1：配置YAML头部引入依赖包 #

在文档最上方的YAML区域加入LaTeX颜色包声明，同时设置编译引擎为xelatex（避免编码问题）：

---
title: "你的文档标题"
output: 
  pdf_document:
    latex_engine: xelatex
header-includes:
  - \usepackage{xcolor}
  # 定义和HTML bootstrap类对应的背景色
  - \definecolor{bg-info}{HTML}{d1ecf1}
  - \definecolor{bg-warning}{HTML}{fff3cd}
---

步骤2：添加knitr钩子全局修改代码块样式 #

在文档最开头的setup代码块中添加如下配置，分别给源代码块、输出块套上对应背景色的样式：

knitr::knit_hooks$set(
  # 自定义源代码块样式
  source = function(x, options) {
    paste0(
      "\\colorbox{bg-info}{\\begin{minipage}{\\dimexpr\\linewidth-2\\fboxsep\\relax}\n",
      "\\texttt{", x, "}",
      "\n\\end{minipage}}"
    )
  },
  # 自定义输出块样式
  output = function(x, options) {
    paste0(
      "\\colorbox{bg-warning}{\\begin{minipage}{\\dimexpr\\linewidth-2\\fboxsep\\relax}\n",
      "\\texttt{", x, "}",
      "\n\\end{minipage}}"
    )
  }
)

可选进阶：使用tcolorbox实现更美观的样式 #

如果需要添加圆角、边框、内边距调整等效果，可替换上述配置为tcolorbox方案：

1. 先修改YAML的header-includes部分：

header-includes:
  - \usepackage[most]{tcolorbox}
  - \definecolor{bg-info}{HTML}{d1ecf1}
  - \definecolor{bg-warning}{HTML}{fff3cd}

2. 替换setup块的钩子配置：

knitr::knit_hooks$set(
  source = function(x, options) {
    paste0(
      "\\begin{tcolorbox}[colback=bg-info, colframe=bg-info!70!black, arc=3pt, boxrule=0.5pt]\n\\texttt{",
      x,
      "}\n\\end{tcolorbox}"
    )
  },
  output = function(x, options) {
    paste0(
      "\\begin{tcolorbox}[colback=bg-warning, colframe=bg-warning!70!black, arc=3pt, boxrule=0.5pt]\n\\texttt{",
      x,
      "}\n\\end{tcolorbox}"
    )
  }
)

完成配置后正常编写代码块即可，所有源代码块会自动加载浅蓝背景，输出块自动加载浅黄背景，和HTML中设置class.source="bg-info", class.output="bg-warning"的效果一致。

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