Quarto块内#|指令失效问题求助

核心问题排查与修复步骤 #

1. 修正YAML元数据格式 #

你的文档头部缺少Quarto要求的YAML边界标记（---），这会导致Quarto无法正确识别文档类型，默认按R Markdown处理，自然不支持#|指令。正确的YAML头部必须用---包裹：

---
title: "Title"
subtitle: "Subtitle"
author: 
  - "Author 1"
  - "Author 2"
date: "November 8, 2022"
date-format: long
format:
  html: 
    code-fold: true
    html-math-method: katex
  pdf:
    cap-location: top
    fig-cap-location: top
    tab-cap-location: top
    papersize: "a4paper"
    geometry: 
      - top=20mm
      - left=25mm
    include-in-header:
      text: |
        \addtokomafont{disposition}{\rmfamily}
  docx: default
---

2. 使用Quarto原生渲染方式 #

如果在RStudio中操作，不要点击传统的「Knit」按钮，而是点击Quarto专属的「Render」按钮。Knit按钮会强制按R Markdown规则渲染，忽略Quarto的新语法特性。

3. 升级Quarto到最新版本 #

早期版本的Quarto对#|注释式指令的支持不完善，建议升级到最新稳定版：

• 终端执行quarto upgrade（已安装Quarto CLI的情况）
• 或从官方渠道下载最新安装包覆盖安装

4. 规范代码块内指令格式 #

确保#|指令是代码块的第一行内容，无前置空行或缩进；同时标签名无需加#前缀，示例代码块格式应为：

#| label: fig-atrip-hist
#| echo: false
#| error: false
#| fig-cap: "atrip Histogram and Density Plot"
#| fig-width: 2
#| fig-height: 3

ggplot(data=df.scaled, aes(atrip))+
  geom_histogram(aes(y = ..density..))+
  geom_density(color = "dark grey", linetype="dashed", fill = "#89f0f4", alpha = 0.6)+
  theme_custom()

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