如何指定Rmd报告目录的展开层级，及默认展开指定章节？

嘿，我来帮你搞定Rmarkdown生成HTML时的目录展开问题，刚好对这个场景挺熟的！下面分两部分给你讲清楚：

一、指定目录默认展开层级 #

默认情况下，开启toc_float: true后，目录只会展开顶级（一级）标题，其他层级都是折叠的。如果你想让目录默认展开到指定层级（比如你设置的toc_depth: 2），有两种方法：

方法1：一键全展开（简单粗暴版） #

直接在toc_float里加个collapsed: false参数就行，这样所有在toc_depth范围内的目录层级都会默认展开。修改你的YAML配置如下：

---
title: "Main document"
date: "16 March 2018"
output:
  html_document:
    mode: selfcontained
    toc: true
    toc_float:
      collapsed: false  # 设为false，所有toc_depth内的层级都会展开
    toc_depth: 2
---

不过这个方法是“全展开”，如果你的目录有三级及以上，三级也会跟着展开，要是你只想精准展开到二级，就用下面的方法。

方法2：精准控制展开层级（自定义版） #

如果只想默认展开到二级目录，三级保持折叠，就在Rmd的末尾加一段JavaScript代码，手动控制目录的展开状态：

<script>
$(document).ready(function() {
  // 找到所有二级目录的父级（一级目录），把它们设为展开状态
  $('.tocify-subheader[data-tag="2"]').parent().addClass('active');
  $('.tocify-subheader[data-tag="2"]').show();
});
</script>

这段代码会在页面加载完成后，自动展开所有一级目录，显示对应的二级目录，三级目录依然保持折叠，完全符合你的toc_depth: 2设置。

二、仅默认展开指定章节（比如最新更新的章节） #

这个需求稍微复杂一点，但用JS也能轻松实现，核心思路是给目标章节加个唯一标识，然后让页面加载时只展开它对应的目录：

步骤1：给目标章节加唯一ID #

在你的Rmd里，给最新更新的章节标题加上专属ID，比如：

## 2024年5月最新更新 {#latest-update-section}

这里的{#latest-update-section}就是给这个二级标题设置的唯一ID，后面JS要靠它定位。

步骤2：添加JS代码控制展开 #

在Rmd的最后（或者任意位置，建议放最后不影响内容）添加这段HTML代码块：

<script>
$(document).ready(function() {
  // 先把所有目录都折叠起来
  $('.tocify-item').removeClass('active');
  $('.tocify-subheader').hide();
  
  // 找到目标章节对应的目录项，展开它和它的所有父级
  var targetDirItem = $('a[href="#latest-update-section"]').closest('.tocify-item');
  targetDirItem.addClass('active');
  targetDirItem.parents('.tocify-item').addClass('active');
  targetDirItem.find('.tocify-subheader').show();
  targetDirItem.parents('.tocify-item').find('.tocify-subheader').show();
});
</script>

这段代码的逻辑很清晰：先把所有目录都收起来，然后精准定位到你标记的最新章节对应的目录项，把它和它的父级目录都设为展开状态，其他旧章节的目录就保持折叠，完美符合你的需求。

完整示例配置 #

结合你原来的YAML，完整的代码示例如下：

---
title: "Main document"
date: "16 March 2018"
output:
  html_document:
    mode: selfcontained
    toc: true
    toc_float: true
    toc_depth: 2
---

## 2023年度总结
这里是旧章节内容，目录会保持折叠

## 2024年第一季度报告
这里是旧章节内容，目录会保持折叠

## 2024年5月最新更新 {#latest-update-section}
这里是最新更新的内容，目录会默认展开

<script>
$(document).ready(function() {
  $('.tocify-item').removeClass('active');
  $('.tocify-subheader').hide();
  
  var targetDirItem = $('a[href="#latest-update-section"]').closest('.tocify-item');
  targetDirItem.addClass('active');
  targetDirItem.parents('.tocify-item').addClass('active');
  targetDirItem.find('.tocify-subheader').show();
  targetDirItem.parents('.tocify-item').find('.tocify-subheader').show();
});
</script>

要注意的是，这里用到的类名（比如tocify-item、tocify-subheader）是Rmarkdown默认html_document输出用的tocify插件的类名，只要你不换自定义模板，这些类名都是稳定的，不用担心兼容性问题。

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