Convert to an HTML document
Format for converting from R Markdown to an HTML document.
html_document(
toc = FALSE,
toc_depth = 3,
toc_float = FALSE,
number_sections = FALSE,
anchor_sections = FALSE,
section_divs = TRUE,
fig_width = 7,
fig_height = 5,
fig_retina = 2,
fig_caption = TRUE,
dev = "png",
df_print = "default",
code_folding = c("none", "show", "hide"),
code_download = FALSE,
self_contained = TRUE,
theme = "default",
highlight = "default",
mathjax = "default",
template = "default",
extra_dependencies = NULL,
css = NULL,
includes = NULL,
keep_md = FALSE,
lib_dir = NULL,
md_extensions = NULL,
pandoc_args = NULL,
...
)toc |
|
toc_depth |
Depth of headers to include in table of contents |
toc_float |
|
number_sections |
|
anchor_sections |
|
section_divs |
Wrap sections in |
fig_width |
Default width (in inches) for figures |
fig_height |
Default height (in inches) for figures |
fig_retina |
Scaling to perform for retina displays (defaults to 2, which
currently works for all widely used retina displays). Set to |
fig_caption |
|
dev |
Graphics device to use for figure output (defaults to png) |
df_print |
Method to be used for printing data frames. Valid values
include "default", "kable", "tibble", and "paged". The "default" method
uses a corresponding S3 method of |
code_folding |
Enable document readers to toggle the display of R code
chunks. Specify |
code_download |
Embed the Rmd source code within the document and provide a link that can be used by readers to download the code. |
self_contained |
Produce a standalone HTML file with no external dependencies, using data: URIs to incorporate the contents of linked scripts, stylesheets, images, and videos. Note that even for self contained documents MathJax is still loaded externally (this is necessary because of its size). |
theme |
One of the following:
|
highlight |
Syntax highlighting style. Supported styles include
"default", "tango", "pygments", "kate", "monochrome", "espresso", "zenburn",
"haddock", and "textmate". Pass |
mathjax |
Include mathjax. The "default" option uses an https URL from a
MathJax CDN. The "local" option uses a local version of MathJax (which is
copied into the output directory). You can pass an alternate URL or pass
|
template |
Pandoc template to use for rendering. Pass "default" to use
the rmarkdown package default template; pass |
extra_dependencies, ... |
Additional function arguments to pass to the
base R Markdown HTML output formatter |
css |
CSS and/or Sass files to include. Files with an extension of .sass
or .scss are compiled to CSS via |
includes |
Named list of additional content to include within the
document (typically created using the |
keep_md |
Keep the markdown file generated by knitting. |
lib_dir |
Directory to copy dependent HTML libraries (e.g. jquery,
bootstrap, etc.) into. By default this will be the name of the document with
|
md_extensions |
Markdown extensions to be added or removed from the
default definition or R Markdown. See the |
pandoc_args |
Additional command line options to pass to pandoc |
See the online
documentation for additional details on using the html_document
format.
R Markdown documents can have optional metadata that is used to generate a document header that includes the title, author, and date. For more details see the documentation on R Markdown metadata.
R Markdown documents also support citations. You can find more information on the markdown syntax for citations in the Bibliographies and Citations article in the online documentation.
R Markdown output format to pass to render
By default, a # is used as a minimalist choice, referring to the id selector in HTML and CSS. You can easily change that using a css rule in your document. For example, to add a link symbol (🔗︎) instead:
a.anchor-section::before {
content: '\01F517\00FE0E';
}You can remove \00FE0E to get a more complex link pictogram (🔗).
If you prefer an svg icon, you can also use one using for example a direct link or downloading it from https://fonts.google.com/icons.
/* From https://fonts.google.com/icons
Licence: https://www.apache.org/licenses/LICENSE-2.0.html */
a.anchor-section::before {
content: url(https://fonts.gstatic.com/s/i/materialicons/link/v7/24px.svg);
}About how to apply custom CSS, see https://bookdown.org/yihui/rmarkdown-cookbook/html-css.html
If you have a set of html documents which you'd like to provide a common global navigation bar for, you can include a "_navbar.yml" or "_navbar.html" file within the same directory as your html document and it will automatically be included at the top of the document.
The "_navbar.yml" file includes title, type, left, and
right fields (to define menu items for the left and right of the navbar
respectively). Menu items include title and href fields. For example:
title: "My Website"
type: default
left:
- text: "Home"
href: index.html
- text: "Other"
href: other.html
right:
- text: GitHub
href: https://github.comThe type field is optional and can take the value "default" or "inverse" (which
provides a different color scheme for the navigation bar).
Alternatively, you can include a "_navbar.html" file which is a full HTML definition of a bootstrap navigation bar. For a simple example of including a navigation bar see https://github.com/rstudio/rmarkdown-website/blob/master/_navbar.html. For additional documentation on creating Bootstrap navigation bars see https://getbootstrap.com/docs/4.5/components/navbar/.
You may specify a list of options for the toc_float parameter which
control the behavior of the floating table of contents. Options include:
collapsed (defaults to TRUE) controls whether
the table of contents appears with only the top-level (H2) headers. When
collapsed the table of contents is automatically expanded inline when
necessary.
smooth_scroll (defaults to TRUE) controls
whether page scrolls are animated when table of contents items are navigated
to via mouse clicks.
print (defaults to TRUE) controls
whether the table of contents appears when user prints out the HTML page.
You can organize content using tabs by applying the .tabset class
attribute to headers within a document. This will cause all sub-headers of
the header with the .tabset attribute to appear within tabs rather
than as standalone sections. For example:
## Quarterly Results {.tabset}
### By Product
### By RegionYou can also specify two additional attributes to control the appearance and
behavior of the tabs. The .tabset-fade attributes causes the tabs to
fade in and out when switching. The .tabset-pills attribute causes
the visual appearance of the tabs to be "pill" rather than traditional tabs.
For example:
## Quarterly Results {.tabset .tabset-fade .tabset-pills}You can provide a custom HTML template to be used for rendering. The syntax
for templates is described in the
pandoc documentation. You can also use
the basic pandoc template by passing template = NULL.
Note however that if you choose not to use the "default" HTML template then several aspects of HTML document rendering will behave differently:
The theme parameter does not work (you can still
provide styles using the css parameter).
For the
highlight parameter, the default highlighting style will resolve to
"pygments" and the "textmate" highlighting style is not available
The toc_float parameter will not work.
The
code_folding parameter will not work.
Tabbed sections (as described above) will not work.
Navigation bars (as described above) will not work.
MathJax will not work if self_contained is
TRUE (these two options can't be used together in normal pandoc
templates).
Due to the above restrictions, you might consider using the includes
parameter as an alternative to providing a fully custom template.
## Not run:
library(rmarkdown)
render("input.Rmd", html_document())
render("input.Rmd", html_document(toc = TRUE))
## End(Not run)Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.