如何控制R Markdown输出PDF文件时的目录放置位置

步骤1：修改YAML头关闭自动插入目录 #

首先把原有YAML配置中的toc: true改为toc: false，关闭默认在文档最开头插入目录的逻辑，其余参数保持不变即可：

---
subtitle: "subtitle"
title: "title"
output: 
  pdf_document:
    toc: false # 关闭自动插目录
    toc_depth: 2
    number_sections: true
---

步骤2：编写前置页面内容 #

在YAML头之后正常编写你需要放在目录前面的前两页内容，可根据分页需要使用\newpage控制分页：

<!-- 第一页前置内容 -->
# 前置说明页1
这是放在目录前面的第一页内容

\newpage
<!-- 第二页前置内容 -->
# 前置说明页2
这是放在目录前面的第二页内容

步骤3：手动插入目录 #

在两页前置内容结束后，插入目录命令即可，目录的样式、层级深度、章节编号都会沿用你YAML中配置的参数：

\newpage
\tableofcontents
\newpage

<!-- 下方开始写正文内容，所有章节会自动被收录到目录中 -->
# 正文第一章
正文内容示例
## 第一章第一节
小节内容示例

说明 #

本方案仅用到了极少量必要的LaTeX命令，无需额外配置复杂的LaTeX代码，生成效果和默认自动生成的目录完全一致。

内容的提问来源于stack exchange，提问作者Daniel Estévez