Quarto搭配papaja渲染apa6_pdf因无效YAML报错问题咨询

目前已有大量使用者完成papaja与Quarto的结合使用，核心是通过兼容层调用papaja的APA 6th格式输出能力，针对配置后提示YAML无效的问题，可按以下步骤排查解决：

• 依赖版本校验
  papaja的稳定CRAN版本暂未提供Quarto原生适配支持，需先安装最新开发版本，在R控制台执行安装命令：remotes::install_github("crsh/papaja")，安装完成后重启R会话，避免版本兼容问题。
• YAML配置结构修正
  直接将papaja::apa6_pdf作为Quarto格式顶级键名的写法不符合Quarto的YAML解析规则，Quarto无法直接识别未做原生适配的R Markdown自定义格式。需通过R Markdown兼容层调用papaja格式，修正后的合法YAML头配置如下：

format:
  rmarkdown::pdf_document:
    base_format: papaja::apa6_pdf
    latex_engine: lualatex
    keep_tex: true

• 格式细节校验
  YAML对缩进、字符格式敏感度极高，配置时需注意：
  • 所有子级参数需比上一级键名多2个半角空格缩进，禁止使用Tab键缩进
  • 所有冒号、标点需使用半角字符，避免混入全角符号、不可见特殊字符
  • 键名与值之间的冒号后必须保留1个半角空格

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