如何让Quarto渲染以下划线开头的QMD文件？

方法一：修改文件忽略规则 #

Quarto默认会把下划线开头的文件判定为局部辅助文件，自动跳过渲染。要覆盖这个规则，在项目根目录创建或编辑.quartoignore文件，添加取反规则：

!chapters/_*.qmd

这行代码的意思是“不要忽略chapters目录下所有下划线开头的.qmd文件”。

接着在_quarto.yml的render字段明确指定要渲染的目标文件：

render:
  - index.qmd
  - about.qmd
  - chapters/_02-Intro_to_analysis_software.qmd

执行quarto render命令即可正常渲染指定的下划线开头文件。

方法二：临时单独渲染指定文件 #

如果只是偶尔需要单独渲染某个文件，无需修改配置，直接在命令行指定文件路径：

quarto render chapters/_02-Intro_to_analysis_software.qmd

这种方式会绕过Quarto的默认忽略规则，直接渲染目标文件。

额外提示 #

下划线开头的文件原本是设计用来嵌入主文档的局部内容，单独渲染时可能丢失主文档的全局样式（比如主题、导航栏）。如果需要保持样式一致，可以在目标文件顶部添加YAML元数据，继承全局配置：

---
title: "分析软件入门"
format: 
  html:
    theme: cosmo
    navbar: true
---

也可以引用独立的全局配置文件：

---
title: "分析软件入门"
format: !include _format.yml
---

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