a. Control the options for every chunk all at once in the setup chunk that appears in every new R Markdown File.
{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE, message = FALSE, warning = FALSE)
knitr::opts_knit$set(root.dir=normalizePath('../'))
knitr::opts_chunk$set, in the above example the code will show for every chunk but there will be no messages or warnings.
knitr::opts_knit$set(root.dir=normalizePath('../')) - If you put your R Markdown file into a sub-folder then it immediately sets the working directory to that folder. This option will set the working directory to the root project directory.
Notice include=FALSE will including nothing from this first chunk in the output of your rendered document (HTML, .docx, .pdf).
b. You can override chunk options by adjusting the individual chunk options. In this example, echo=FALSE will result in the code not showing:
{r setup, echo=FALSE, figure.align = 'center', fig.width = 6, fig.length = 4}
hist(mtcars$mpg)
In the above chunk, we also centered the figure and we set the width and length of the figure. You can add these figure modifications to all chunks in opts_chunk$set code.
Further chunk options can be found at the following site.
You can use the following functions when you want to create a new page for a new section in your document. These work for PDF and WORD documents. It’s the same as adding a “page break” in word when, for example, you want to start your method section on a new page when writing a research paper. Other times, it’s simply more aesthetically pleasing to start on a new page. The following instructions tell you how to do this in R Studio for PDF and WORD outputs.
a. Create a page break when you render using .pdf
You can add a line break, a new separate page on a .pdf if you add the \break command. This does not work for .html or for .docx. Add it to any part of the document outside of a chunk
\break
b. Create a page break when you render using .docx.
If you want to do so for .docx the instructions are pretty straightforward and can be found at this website:
https://datascienceplus.com/r-markdown-how-to-insert-page-breaks-in-a-ms-word-document/
The steps can be broken down as follows:
Render a word doc and save is as something like “rmarkdown_template.docx” and save in the same folder as your code.
Open the new word file and change the style template as noted on the website. There are several steps.
Save the template.
In the YAML (the code at the very top with you name), remove the default and add the following under word_document:
reference_docx: rmarkdown_template.docx
Notice in the above section that the number formatting comes out nicely. However, you can create bullets too:
- Render a word doc and save is as something like "rmarkdown_template.docx" and save in the **same** folder as your code.
- Open the new word file and change the style template as noted on the website. There are several steps.
- Save the template.
- In the YAML (the code at the very top with you name), remove the `default` and add the following under
- word_document:
reference_docx: rmarkdown_template.docx
Render a word doc and save is as something like “rmarkdown_template.docx” and save in the same folder as your code.
Open the new word file and change the style template as noted on the website. There are several steps.
Save the template.
In the YAML (the code at the very top with you name), remove the default and add the following under
word_document:
reference_docx: rmarkdown_template.docx
You can get fancy with equations:
$$\begin{array}{ccc}
x_{11} & x_{12} & x_{13} \\
x_{21} & x_{22} & x_{23}
\end{array}$$
Sometimes in describing your results you might want to quote a famous person for inspiration:
> "Today is only one day in all the days that will ever be. But what will happen in all the other days that ever come can depend on what you do today."
>
> --- Ernest Hemingway, _For Whom the Bell Tolls_
“Today is only one day in all the days that will ever be. But what will happen in all the other days that ever come can depend on what you do today.”
— Ernest Hemingway, For Whom the Bell Tolls
---
title: "R Markdown Tips"
author: "Jamie Bedics"
date: "`r format(Sys.time(), '%d %B, %Y')`"
output:
html_document:
toc: true
pdf_document: default
word_document: default
---
a. You can add a TOC for all rendered output.
Notice in the above YAML, that under .html there is a toc: true and there is no default statement like there is for word and pdf.
The TOC YAML option is a nice feature for your documents especially when they’re lengthy.
b. Floating TOC
The floating TOC is a nice option when rendering to HTML. Add toc_float = true under toc: true and under the html_doucment heading in your YAML.
Additional tips on html can be found here at R Studio.