Word基础知识

概述

使用docx格式创建MS Word输出。例如：

---
title: "我的文档"
format:
  docx:
    toc: true
    number-sections: true
    highlight-style: github
---

这个例子展示了一些可用于MS Word输出的选项。本文档详细介绍了这些选项以及其他选项。有关所有可用选项的完整列表，请参阅Word格式参考。

要了解如何为docx格式创建自定义模板，请参阅Word模板一文。

目录

使用 toc 选项可以在输出文档中包含一个自动生成的目录。使用 toc-depth 选项可以指定在目录中包含的章节级别数量。默认值是 3（这意味着一级、二级和三级标题将列在目录中）。例如：

toc: true
toc-depth: 2

你可以使用 toc-title 选项自定义目录的标题：

toc-title: Contents

如果你想从目录中排除某个标题，可以为其添加 .unnumbered 和 .unlisted 类：

### More Options {.unnumbered .unlisted}

章节编号

使用 number-sections 选项为输出文档中的章节标题添加编号。例如：

number-sections: true

使用 number-depth 选项指定要添加编号的标题的最深层次（默认情况下所有标题都会编号）。例如：

number-depth: 3

要排除单个标题的编号，请为其添加 .unnumbered 类：

### 更多选项 {.unnumbered}

语法高亮

Pandoc 会自动高亮显示带有语言名称标记的 围栏代码块 中的语法。例如：

```python
1 + 1
```

Pandoc 可以为超过 140 种不同的语言提供语法高亮（查看 quarto pandoc --list-highlight-languages 的输出以获取所有支持的语言列表）。如果你想为不支持的语言提供高亮代码块的外观，只需使用 default 作为语言名称。

你可以使用 highlight-style 并指定一个支持的主题来指定代码高亮样式。支持的主题包括：arrow、pygments、tango、espresso、zenburn、kate、monochrome、breezedark、haddock、atom-one、ayu、breeze、dracula、github、gruvbox、monokai、nord、oblivion、printing、radical、solarized 和 vim。

例如：

highlight-style: github

高亮主题可以提供单一的高亮定义，或者提供两种定义，一种针对浅色背景优化，另一种针对深色背景优化。当可用时，Quarto 会根据代码块背景颜色的深浅自动选择合适的样式。你始终可以选择指定完整名称（例如 atom-one-dark）来绕过这种自动行为。

默认情况下，代码使用 arrow 主题进行高亮，该主题针对可访问性进行了优化。以下是 arrow 浅色和深色主题的示例：

展示 Arrow 浅色主题的代码块。

展示 Arrow 深色主题的代码块。

代码注释

你可以在代码块和可执行代码单元格中为代码行添加注释。详见代码注释。