Week19: Markdown and RMarkdown

特性与用途

• 简单
• 结构化-转换
  • Word
  • PDF
  • HTML
  • …
• 多编辑器支持
  • Typora
  • RStudio
  • Jupyter notebook
  • VS Code
  • …

Markdown 效果（以 Typora 为例）

图片：

标题：

列表：

表格：

代码块：

数学公式（LaTex语法）：

流程图：

行内元素：

各种格式转换：

RMarkdown 效果

R 包文档（knitr 和 rmarkdown）：

博客与网站（blogdown）：

用于重复分析和研究展示：

书籍（bookdown）：

基础语法和用法

目前对于两者的介绍网上一大堆，而且本身语法简单，上手很快，这里不会过多介绍。本文的核心在于让读者了解这些工具以及根据需要去学习和利用它们。这里主要为初学者提供比较有参考价值的资料：

• RMarkdown 参考手册，这里单纯的 Markdown 语法关注第一页，后续则被 RMarkdown 和其引擎 knitr 所拓展，镜像：https://www.jianguoyun.com/p/DUV0ewgQ6uuVCBjRtr4D。
• RMarkdown 小抄，打印使用，镜像：https://www.jianguoyun.com/p/Da0QaqwQ6uuVCBjNtr4D。
• RStudio 网站介绍：https://rmarkdown.rstudio.com/lesson-1.html。
• yihui 的 RMarkdown 权威指南。
• yihui 的 RMarkdown cookbook。
• yihui 的 blogdown。
• yihui 的 bookdown。

仔细阅读上面的资料，其他资料基本没有学习的必要。

关于 RMarkdown knitr 相关设置，yihui 的文档网站有比较好的解释：https://yihui.org/knitr/。

另外有时候文章代码需要格式化，推荐下面两个 R 包

• formatR
• styler

注意，在使用 RMarkdown 时，使用 RStudio 提供的 knit 按钮是非必须的，我们可以直接通过 R 命令执行这一渲染（格式转换）过程，如 rmarkdown -> html：

rmarkdown::render("week19/example.Rmd", output_format = "html_document")

如果是使用 bookdown 写书，则是：

bookdown::render_book("index.Rmd")