Quarto技巧：HTML渲染隐藏标题，保留RStudio大纲显示

解决方案（Quarto / R Markdown通用） #

要实现「标题在RStudio大纲可见，但HTML输出隐藏」的效果，可通过自定义标题类 + CSS隐藏的方式完成，步骤如下：

1. 给需要隐藏的标题添加自定义类（比如.outline-only）

   ## 加载库 {.outline-only}
   
   ```{r setup, echo=FALSE}
   library(tidyverse)
   # 其他数据处理代码
   

2. 在文档开头添加CSS代码块，设置该类标题在HTML中隐藏

   ```{css, echo=FALSE}
   /* 隐藏仅用于大纲导航的标题 */
   .outline-only {
     display: none;
   }
   

设置完成后：

• RStudio的大纲面板会正常识别带.outline-only类的标题，可快速跳转对应章节
• HTML输出中该标题会被完全隐藏，不会出现「空标题占位」的问题

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