生成 Word 文档

Quarto 转 Word 功能有限, 仅仅可以作为辅助工具

1 概述

下面范例展示了如何用 Quarto 生成 .docx 文档 :

生成Word最基础范例

为了在 Chrome 浏览器中查看 .docx 文档, 需要安装谷歌的官方插件 Office Editing for Docs, Sheets & Slides。 这样构建完成的 word 文件可以用 Chrome 浏览器打开

2 目录

使用 toc 选项可在输出文档中生成自动目录。使用toc-depth 选项可指定目录中包含的章节层级数。默认值为 3(即一级、二级和三级标题都会列在目录中) :

设置目录层级

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

设置目录标题

如果某个章节不希望出现在目录中, 可以像下面这样设置 :

### More Options {.unnumbered .unlisted}

3 章节编号

下面范例给4级深的章节进行编号 :

章节编号

若要将某个章节排除编号, 可以像下面这样设置 :

### 杜甫{.unnumbered}

4 模板

如果想要自定义 Word 输出的外观,Pandoc 支持一种特殊类型的模板,称为 参考文档 reference document。下面是为 docx 指定自定义参考文档的示例 :

使用自定义模板生成word文档

4.1 创建模板

要基于 Pandoc 默认模板创建新的 参考文档 reference document, 请执行以下命令 :

quarto pandoc -o custom-reference-doc.docx –print-default-data-file reference.docx

可以从 Word 中打开 “样式” 窗口, 将光标移动到文档中的某个元素上时,样式列表中的某一项会被高亮显示 :

查看样式列表

如果要修改任何元素的样式, 可以点击高亮项的下拉菜单, 然后会弹出对话框并进行修改 :

修改样式表

4.2 应用自定义样式

下面范例将一段文本设置成样式 BlueEmphasis :

使用自定义样式BlueEmphasis的范例

5 链接