用途：创建可复现的 Quarto 文档，用于分析报告、演示文稿或网站，也可从 R Markdown 迁移。
主要能力：配置 YAML 头部（标题、作者、日期、format、execute、bibliography）；编写带 {r} 代码块的内容；使用 #| 语法设置代码块选项（label、echo、eval、output、fig-width、fig-height、fig-cap、tbl-cap、cache）；添加交叉引用（@fig-、@tbl-）与文献引用（@key）；渲染为 html、pdf、docx、revealjs 等格式；支持多格式输出与实时预览。
使用方式：创建 report.qmd 并写入 YAML 头部；用 {r} 代码块编写内容，label 前缀需匹配引用类型（图用 fig-，表用 tbl-）；用 #| 设置块选项；用 @fig-name、@tbl-name、@key 引用；执行 quarto render report.qmd 渲染，或加 --to pdf/docx 指定格式，quarto preview report.qmd 预览。PDF 需 LaTeX 引擎，可用 quarto install tinytex 安装 TinyTeX。
适用场景：可复现分析报告、含代码的演示、由代码生成 HTML/PDF/Word 文档、R Markdown 迁移。
限制与注意：交叉引用需正确 label 前缀；缓存块在上游数据变化时不会重跑，需删除 _cache/ 强制刷新；PDF 缺少 LaTeX 会报错；应使用 #| 块选项而非旧式 {r, echo=FALSE} 语法。具体安装与平台细节以官方文档为准。