PowerPoint

概述

您可以使用 pptx 格式创建 PowerPoint 演示文稿。PowerPoint 演示文稿支持核心演示功能，如增量项目符号、两栏布局和演讲者备注，并且还可以使用自定义 PowerPoint 模板 进行渲染。

有关 PowerPoint 输出可用选项的完整列表，请参阅 PowerPoint 格式参考。

创建幻灯片

在 Markdown 中，幻灯片通过标题来划分。例如，这里有一个包含两张幻灯片的简单演示文稿（每张幻灯片由二级标题（##）定义）：

---
title: "Habits"
author: "John Doe"
format: pptx
---

## 起床

- 关闭闹钟
- 下床

## 睡觉

- 上床
- 数羊

你还可以使用一级标题（#）将演示文稿分成多个部分，并使用标题幻灯片。例如：

---
title: "Habits"
author: "John Doe"
format: pptx
---

# 早晨

## 起床

- 关闭闹钟
- 下床

## 早餐

- 吃鸡蛋
- 喝咖啡

# 晚上

## 晚餐

- 吃意大利面
- 喝葡萄酒

## 睡觉

- 上床
- 数羊

最后，你还可以使用水平线来划分幻灯片（例如，如果你有一张没有标题的幻灯片）：

---
title: "Habits"
author: "John Doe"
format: pptx
---

- 关闭闹钟
- 下床

---

- 上床
- 数羊

上面的示例都使用二级标题来定义幻灯片，使用一级标题来定义部分/标题幻灯片。你可以使用 slide-level 选项来自定义这一点（有关更多详细信息，请参阅 Pandoc 文档中的 结构化演示文稿）。

增量列表

默认情况下，幻灯片中的数字和项目符号列表会一次性全部显示。你可以使用 incremental 选项全局覆盖此行为。例如：

title: "我的演示文稿"
format:
  pptx:
    incremental: true

你还可以通过在 div 中添加显式类来明确指定任何列表是增量显示还是非增量显示。要使列表增量显示，请执行以下操作：

::: {.incremental}

- 吃意大利面
- 喝红酒

:::

要使列表非增量显示，请执行以下操作：

::: {.nonincremental}

- 吃意大利面
- 喝红酒

:::

多列布局

要将内容并排显示在多列中，可以使用带有 .columns 类的原生 div 容器，其中包含两个或更多带有 .column 类的 div 容器：

:::: {.columns}

::: {.column}
内容...
:::

::: {.column}
内容...
:::

::::

演讲者备注

你可以使用带有 .notes 类的 div 为幻灯片添加演讲者备注。例如：

## 带有演讲者备注的幻灯片

幻灯片内容

::: {.notes}
演讲者备注放在这里。
:::

PowerPoint 模板

默认情况下，PowerPoint 输出使用一个相当简洁的模板。您可以通过 reference-doc 选项自定义使用的模板。例如：

---
title: "演示文稿"
format:
  pptx:
    reference-doc: template.pptx
---

最近版本的 PowerPoint 中包含的几乎所有模板（带有 .pptx 或 .potx 扩展名）都已知可以正常工作，大多数从这些模板派生的模板也是如此。

具体要求是，模板应包含以下名称的布局（在 PowerPoint 中查看，点击 Home 菜单下的 Layout 进行检查）：

  • 标题幻灯片
  • 标题和内容
  • 节标题
  • 两栏内容
  • 对比
  • 带标题的内容
  • 空白

对于每个名称，将使用找到的第一个具有该名称的布局。如果没有找到具有其中一个名称的布局，Pandoc 将输出警告，并使用默认 reference-doc 中的具有该名称的布局。

创建模板

要从头开始创建模板，请从默认 PowerPoint 模板开始，如下所示：

Terminal
quarto pandoc -o template.pptx --print-default-data-file reference.pptx

然后在 PowerPoint 中根据需要编辑 template.pptx 文件，并在渲染您的幻灯片时将其用作 reference-doc 的值（如上所示）：

幻灯片布局

在创建幻灯片时，pptx 写入器会根据幻灯片内容从多个预定义布局中选择：

标题幻灯片

此布局用于初始幻灯片，如果存在，则从元数据字段 date、author 和 title 生成并填充。

节标题

此布局用于 Pandoc 称之为“标题幻灯片”的内容，即幻灯片以层次结构中高于幻灯片级别的标题开头。

两栏内容

此布局用于两栏幻灯片，即包含带有 columns 类的 div，其中至少包含两个带有 column 类的 div。

对比

此布局用于任何两栏幻灯片，其中至少有一栏包含文本后跟非文本内容（例如图像或表格）。

带标题的内容

此布局用于任何非两栏幻灯片，其中包含文本后跟非文本内容（例如图像或表格）。

空白

此布局用于仅包含空白内容的任何幻灯片，例如仅包含演讲者备注的幻灯片，或仅包含非换行空格的幻灯片。

标题和内容

此布局用于所有不符合其他布局标准的幻灯片。

除非使用 reference-doc 指定了替代参考文档，否则这些布局将从 Pandoc 附带的默认 pptx 参考文档中选择。

背景图像

要为 PowerPoint 演示文稿中的多个幻灯片提供共同的背景图像，请在自定义 PowerPoint 模板的相应幻灯片布局中包含背景图像（有关创建模板的详细信息，请参阅创建模板）。

要将背景图像添加到单个幻灯片，请将 background-image 属性添加到幻灯片的标题中。例如：

## 幻灯片标题 {background-image="background.png"}

请注意，即使您没有幻灯片标题文本，这也适用。例如：

## {background-image="background.png"}

对于背景图像，仅支持“拉伸”模式，背景图像以图像的较大轴为中心围绕幻灯片，与 PowerPoint 的默认行为一致。