如何使用Quarto创建自定义幻灯片 复刻PowerPoint母版布局

步骤1：导出基准参考模板 #

首先在终端执行命令，导出Quarto内置的默认PPT模板作为修改基底：
quarto pandoc -o custom_template.pptx --print-default-data-file reference.pptx #

步骤2：编辑模板匹配目标样式 #

一定要用桌面版Microsoft PowerPoint打开导出的custom_template.pptx，不建议用WPS、在线PPT工具编辑，避免母版占位符识别异常：

• 顶部菜单栏选择「视图」-「幻灯片母版」进入母版编辑模式
• 先调整最顶部的主母版：设置全局统一的字体规则、主题配色、背景样式、固定logo、页脚/页码位置，所有下属子版式会自动继承主母版的全局设置
• 再逐个调整下方的子版式（包括封面页、目录页、单栏内容页、双栏内容页、节分隔页等你需要用到的版式）：对齐占位符的位置、尺寸，设置每个占位符内的字体格式、段落间距，删除你不需要的默认占位符
  关键提醒：不要修改、删除占位符的内置名称（比如默认的“标题占位符”“内容占位符”），否则Quarto渲染时无法将文档内容正确填充到对应位置
• 所有样式调整完成后，退出母版编辑模式，删除模板内自带的所有示例幻灯片，保存文件即可。

步骤3：渲染时调用自定义模板 #

在你的Quarto幻灯片源文件的YAML配置块中，指定reference-doc参数为你编辑好的模板路径，示例配置如下：

---
title: "你的演示文稿标题"
format:
  pptx:
    reference-doc: custom_template.pptx
---

配置完成后正常执行quarto render命令渲染，输出的PPT就会完全套用你设置的母版布局，无需二次手动调整样式。

排错提示：如果渲染后部分样式未生效，优先检查两个点：一是编辑模板时是否改动了占位符的内置名称，二是模板文件是否设置了密码保护、存放在含中文/特殊字符的路径下。

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