pdf-html-word.qmd

# HTML, PDF, and Word (and more!)

One of the really great, powerful things about rmarkdown is that we can convert it to many different output types. The top three that you might be most likely to use are HTML, PDF, and Microsoft Word. There are others that we can discuss later.

In this section, we are going to briefly discuss how to render to these output formats, and some things that you might want to do for each of them.

## Overview

* **Teaching**: 10 minutes
* **Exercises**: 15 minutes

## Questions

* How do I convert to HTML, PDF, or Word?
* How do I set options specific to each of these?
* How can I include a screenshot of an interactive graphic in PDF or Word?

## Objectives

## How do I convert to HTML, PDF, or Word?

Here are three ways to do this:

1. You can control this in the "knit" button

```{r knit-screenshot, eval = TRUE, echo = FALSE}
knitr::include_graphics("figs/rstudio-knit-button.png")
```

You might notice that depending on the option you select, this changes things in the YAML - which is another way to control which output you have:

2. You can change the YAML option 

```YAML
title: "Exploring gapminder"
output: html_document
```

```YAML
title: "Exploring gapminder"
output: pdf_document
```

```YAML
title: "Exploring gapminder"
output: word_document
```

And if we remember from the previous lesson, the information in the YAML is passed into the `render` function:

3. You can call the `render` function.

```{r rmd-render, eval = FALSE}
rmarkdown::render("example.Rmd", output_format = "html_document")
rmarkdown::render("example.Rmd", output_format = "pdf_document")
rmarkdown::render("example.Rmd", output_format = "word_document")
```

### A note on workflow with rmarkdown: HTML first, PDF/word later

It can be easy to get caught up with how your document looks. I highly recommend avoiding compiling to PDF or word until _you really need to_. [This is also recommended by the author of rmarkdown and knitr, Yihui Xie](https://yihui.name/en/2018/07/in-html-i-trust/). Because HTML doesn't have page breaks, this means that you can spend time working on generating content, and not trying to get figures to line up correctly. 

## Your Turn {.exercise}

1. Generate three reports, one as HTML, one as PDF, and one as microsoft word. Remember, if you are having PDF problems, see the installation chapter note on installing \LaTeX\ with the R package, `tinytex`.