本推文是 “手把手教你使用 Quarto 构建文档” 教程的第一部分，本文先介绍
- Quarto 构建文档的原理；
- 可创建的文档类型；
- 对应的参考资源分享。
下一部分，会手把手介绍如何使用它（下次推文吧～）。
简介
Quarto 是一个建立在 Pandoc 上的开源科技出版系统。
-
可以基于 Python、R、Julia 和 Observable 创建动态内容。
-
以纯文本 markdown 或 Jupyter 笔记本的形式编写文档。
-
以 HTML、PDF、MS Word、ePub 等格式发布高质量的文章、报告、简报、网站、博客和书籍。
-
用科学的 markdown 进行创作，包括方程、引文、交叉引用、图板、呼号、高级布局等等。
基于四种不同语言构建的文档，小样如下：
类型与 R Markdwon 比较类似。第一部分是 YAML，后面是正文内容（包含：文字，代码等）。
小编认为如果你会了 R Markdown 制作各类文档，你再来看这些内容，应该一点难度都没有。两者其实非常相似。如果你焦虑是否需要转站 Quarto 构建文档，或许你可以看看谢大写的博客。
它是如何工作的？
在渲染 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 文档。
-
官网的基于 R 语言的 Quarto 文档教程
-
RStudio 举办的 R 会议等给出了一些视频教程。小编将一些最新的教程搬运到了 B 站，供大家学习：
- 其他相关的博客1，2 等。
