第 4 周

rmarkdown 与 Quarto

---

在上一讲课后作业中同学们通过代码脚本文档 L02_coding_practice.R 完成编程作业并直接提交，但如果不运行同学们的代码，我将很难得知代码能否正常运行及其运行结果；同时通过注释方式添加说明性文字或给文档逻辑分节也显得笨拙和不够美观。那么，有没有更好的解决方案呢？答案就是本讲将要介绍的“动态文档”（dynamic documents）——它允许你将代码、代码输出、文字等有机地组合在一起，并可方便地转化为多种类型的输出格式（如网页、PDF、docx、幻灯片等）。

本讲主要涵盖以下几方面的内容：

• R Markdown 与 Quarto 简介

• Quarto 动态文档组成

  • YAML 文件头
  • Markdown 文本
  • 代码块

• Quarto 工作流与随堂练习

• 补充：prettydoc、tufte 和 xaringan …

---

1. 课前准备

📖 预习 R for Data Science, 2e关于如何使用 Quarto 记录数据科学研究过程并展示与沟通研究结果的内容，即 29 Quarto 。

此书第1版有中文翻译版 《R数据科学》出版，上述内容大致对应“第20章 R Markdown” 和 “第23章 R Markdown工作流”（但使用 R Markdown 而非 Quarto）。若同学们觉得直接阅读英文原版教材有点吃力 / 费时，可参阅中文翻译版。

📖 阅读 Markdown基础 一文。

此文主要翻译自 Quarto 官方文档 Markdown Basics 并经小幅改写。

🖥️ 我准备的基于 xaringan包 的 网页版讲义，供同学们参考。

2. 课堂讲义

🖥️第3讲 rmarkdown 与 Quarto

3. 随堂练习

⌨️ 本讲将有比较长时间的随堂编程练习，请同学们带上自己的笔记本电脑 （也可找上编程小伙伴，坐在一起结队练习效果可能更佳，😁）。

4. 课后作业

✍️ 课后作业