Quarto YAML中如何使用相对路径引用Logo？

直接用相对路径（最简便） #

按你的项目结构，在每个仪表盘的YAML头部直接写相对于当前.qmd文件的路径就行，注意别加多余引号（路径有空格才需要）：

title: "你的仪表盘标题"
format:
  dashboard:
    logo: logos/你的logo文件名.png

Windows系统路径用正斜杠/或者双反斜杠\\都能识别，优先用正斜杠，跨平台不踩坑。

用Quarto内置资源变量兜底 #

如果上面的方法还是不行，试试Quarto的$resources_dir$变量，先在YAML里声明资源目录，再引用：

title: "你的仪表盘标题"
resources: ["logos"]
format:
  dashboard:
    logo: $resources_dir$/你的logo文件名.png

检查工作目录 #

渲染时如果工作目录不是项目根目录，路径也会失效。在RStudio里直接通过Session > Set Working Directory > To Project Directory把工作目录设为项目根目录，再重新渲染。

排查小技巧 #

• 核对文件名、路径的大小写（Linux/macOS系统大小写敏感）
• 确认Logo格式是Quarto支持的（png、jpg、svg都可以）
• 看渲染时的控制台日志，有没有“文件找不到”的报错，能快速定位问题

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