R 语言经典实例（原书第 2 版）

474

｜

第

16

章

16.2 添加标题、作者或日期

16.2.1 问题

需要更改文档的标题、作者或日期。

16.2.2 解决方案

在 R Markdown 文档的顶部是一段特殊格式的文本，以 --- 开头和结尾。此块包含有关

文档的重要元数据。在此块中，可以设置标题、作者和日期：

---

title: "Your Title Here"

author: "Your Name Here"

date: "12/31/9999"

output: html_document

---

也可以设置输出格式（例如，output: html_document）。我们稍后将在涵盖特定格

式的方法中讨论不同的输出格式。

16.2.3 讨论

当编写R Markdown 文档以创建输出时，R 将运行每个块，为每个块的输出创建

Markdown（而不是 R Markdown），并将完整的 Markdown 文档传递给 Pandoc。Pandoc

是从中间 Markdown 创建最终输出文档的软件。大多数情况下，除非在编写文档时遇到

问题，否则不需要考虑这些步骤。

在 --- 标记之间的 R Markdown 文档顶部的文本采用称为 YAML（又一种标记语言）的

格式。此块用于将元数据传递给构建输出文档的 Pandoc 软件。字段 title、author

和 date 由 Pandoc 读取并插入大多数输出文档格式的顶部。

这些值的格式化和插入输出文档的方式取决于模板用于输出的功能。HTML、PDF

和 Microsoft Word 的默认模板各自格式化 ...