Introduction to RMarkdown

2 half days (9.30 am -12.30)

Dates available:

  • October: 18/10/22 and 19/10/22
  • February: 06/02/23 and 07/02/23
  • April: 04/04/23 and 05/02/23

Intro to RMarkdown

Why RMarkdown

RMarkdown is a powerful way of coding manuscripts, reports and managing workflows in R. It can combine many programming languages, along with text and can be extended to build a range of things, including websites.

RMarkdown can be used to produce documents of any type, from pdfs and presentation slides to (accessible!) html files supporting interactivity and, behind the scenes, mixing up code with text in a seamless way that feels almost magical. RMarkdown is a natural extension to analysis coding in R and many institutions that teach R use RMarkdown from the first day due to its flexibility for work flow.

Learning Outcomes:

After this one-day introduction, delegates will:

  1. Understand more about how RMarkdown works.
  2. Learn about the ways of getting the most out of RMarkdown using the RStudio IDE.
  3. Learn how to use Command Line to “code” even more functionality that RMarkdown offers.

Delegates will:

  1. Learn about the markdown part of markdown in how to format Text.
  2. Will be introduced to how to include images into RMarkdown.
  3. Learn more about RMarkdown’s code chunks and explore what their settings do.
  4. How to mix up code in your text in order to automate analysis.
  5. Learn more about setting out reports using tabs and how to automate these for very long reports.
  6. Explore the output formats that are possible with RMarkdown.
  7. Learn about parameters which are used to produce multiple reports that have distinct values for certain categories, for example departments or geographical regions.
  8. Be introduced to the power of the Command line coding in relation to RMarkdown which is a step away from using the click once (Graphical User Interface) functionality offered by RStudio.
  9. Be briefly introduced to loops in relation to using parameters.
  10. Learn about taking existing R scripts and making them RMarkdown (without copying and pasting) and back again.
  11. Learn about incorporating SQL code into RMarkdown.


Some prior knowledge of R is required and has either attended the NHS-R Community Introduction to R and R Studio course or have used some R (but by no means an “expert”).

You are expected to have completed the prework and set up an account with RStudio Connect.

If you are wanting to use your own computer/RStudio the instructions in this prework will equally work for installing the packages required and the files for the course.

Your Trainer:

Zoë Turner, Data Scientist at Nottinghamshire Healthcare NHS Foundation Trust.

Audience: Data Analysts, and anyone interested in learning about RMarkdown, in Integrated Care Systems in the Midlands. 

Duration and start date
2 half days (9.30 am -12.30)

Dates available:

  • October: 18/10/22 and 19/10/22
  • February: 06/02/23 and 07/02/23
  • April: 04/04/23 and 05/04/23


Registration: Please use the online form below.

For more information about this course, please contact the Training & Development Operational Lead, Rachel Caswell (