Chapter 1 Installation

To use R Markdown, you have to install R (R Core Team 2020) and the R package rmarkdown (Allaire, Xie, McPherson, et al. 2020).

  1. # install the rmarkdown package from CRAN in R
  2. install.packages("rmarkdown")
  3. # or install from GitHub if you want to test the
  4. # development version
  5. if (!requireNamespace("remotes")) install.packages("remotes")
  6. remotes::install_github("rstudio/rmarkdown")

Unless you have a favorite editor or IDE (Integrated Development Environment), we recommend that you also install the RStudio IDE (https://www.rstudio.com). RStudio is not required, but it will make it easier for an average user to work with R Markdown because of the strong editor support. If you choose not to use the RStudio IDE, you will need to install Pandoc (see Section 1.1), which is the tool used by rmarkdown to convert Markdown to other document formats.

If you need to create PDF output, you may need to install LaTeX (Section 1.2) and certain LaTeX packages (Section 1.3).

References

Allaire, JJ, Yihui Xie, Jonathan McPherson, Javier Luraschi, Kevin Ushey, Aron Atkins, Hadley Wickham, Joe Cheng, Winston Chang, and Richard Iannone. 2020. Rmarkdown: Dynamic Documents for r. https://github.com/rstudio/rmarkdown.

R Core Team. 2020. R: A Language and Environment for Statistical Computing. Vienna, Austria: R Foundation for Statistical Computing. https://www.R-project.org/.