Quarto渲染MS Word文档时如何制作封面及处理目录放置问题

一、添加封面的两种实用方法 #

1. 基于Word模板（推荐） #

先在Word中制作好带封面的模板文件（比如命名为custom-template.docx），把封面设计、正文样式都调整到位。然后在Quarto的YAML配置里指定这个模板：

format:
  docx:
    reference-doc: custom-template.docx
    toc: true

渲染后，模板里的封面会被完整保留，目录默认会放在封面之后的位置。

2. 直接在Quarto文档中编写封面内容 #

如果不想用模板，就在.qmd文件最开头编写封面内容，用---和正文明确分隔：

---
format:
  docx:
    toc: true
---

# 项目文档封面
**项目副标题**  
作者：张三  
创建日期：2024年5月20日

---

## 项目概述
这里开始写正文内容...

这种方式下，封面会作为独立内容块，目录会自动排在封面之后。

二、解决目录位置的棘手问题 #

1. 用toc-location参数（Quarto 1.3+版本支持） #

从Quarto 1.3版本开始，新增了toc-location参数，可直接指定目录放在封面之后：

format:
  docx:
    toc: true
    toc-location: after-title

这个参数能精准控制目录紧跟标题/封面页，是最省心的方案。

2. 配合Word模板自定义位置 #

在你的Word模板里，在封面之后预留好目录的位置（可以插入Word自带的目录占位符），Quarto渲染时会自动把生成的目录放到这个位置，适合需要高度定制格式的场景。

3. 手动插入目录标记 #

如果需要把目录放在任意位置，先关闭自动目录，然后在目标位置插入{{< toc >}}标记：

format:
  docx:
    toc: false  # 关闭自动生成目录
---

# 封面内容
...

{{< toc >}}

## 正文第一章
...

这种方式完全手动控制目录位置，灵活度最高。

额外提示 #

• 尽量使用最新版Quarto，目录相关的功能在新版本中更完善。
• 使用Word模板时，建议保留Quarto默认样式的基础上修改，避免格式冲突。

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