手把手教你使用 Quarto 构建文档 (1)

本推文是 “手把手教你使用 Quarto 构建文档” 教程的第一部分，本文先介绍

1. Quarto 构建文档的原理；
2. 可创建的文档类型；
3. 对应的参考资源分享。

下一部分，会手把手介绍如何使用它（下次该系列推文见吧～）。

简介

Quarto^[1] 是一个建立在 Pandoc 上的开源科技出版系统。

• 可以基于 Python、R、Julia 和 Observable 创建动态内容。

• 以纯文本 markdown 或 Jupyter 笔记本的形式编写文档。

• 以 HTML、PDF、MS Word、ePub 等格式发布高质量的文章、报告、简报、网站、博客和书籍。

• 用科学的 markdown 进行创作，包括方程、引文、交叉引用、图板、呼号、高级布局等等。

基于四种不同语言构建的文档，案例如下（左边为源码，右边为输出结果）：

类型与 R Markdwon 比较类似。第一部分是 YAML，后面是正文内容（包含：文字，代码等）。

小编认为如果你会了 R Markdown 制作各类文档，你再来看这些内容，难度应该都不大。两者其实非常相似。如果你有这样的担心：是否需要转战 Quarto 构建文档？，或许你可以看看谢益辉写的博客^[2]。

它是如何工作的？

在渲染 Quarto 文档时，首先执行所有代码块，并创建一个新的 markdown (.md) 文档，内部包括代码及其输出。然后由 pandoc 处理创建最终的格式（PDF、Word 等）。而这整个步骤都封装到了 Render 按钮中，读者只需要点击 Render 按钮即可编译得到对应的输出文档（各类文档，下一节讲给出）。

可创建的文档类型

官网给出了很多很创建的文档类型，并开源了对应的代码。读者可以尝试下载，并读懂，并将其为己所用。这里小编将其简单罗列了下：

文章和报告

具体模板可见：https://quarto.org/docs/gallery/#articles-reports

幻灯片

具体模板可见：https://quarto.org/docs/gallery/#presentations

交互式文档

具体模板可见：https://quarto.org/docs/gallery/#interactive-docs

网站

具体模板可见：https://quarto.org/docs/gallery/#websites

书籍

具体模板可见：https://quarto.org/docs/gallery/#books

资源分享

本文主要分享基于 R 语言创建 Quarto 文档。

1. 官网的基于 R 语言的 Quarto 文档教程^[3]

1. RStudio 举办的 R 会议等给出了一些视频教程。小编将一些最新的教程搬运到了 B 站，供大家学习：

1. 其他相关的博客1^[4]，2^[5] 等。

参考资料