Travis-CI Build Status CRAN_Status_Badge CRAN Downloads

This R package provides ready-to-use HTML output formats and templates for RMarkdown documents. The goal is to produce clean documents "out of the box", with or without the RStudio IDE.

The package provides several HTML output formats. You can click on an image to see a real HTML output sample.

material format

Format taken from the Material design theme for Bootstrap 3. Document is split into pages at each <h1> header, and the table of contents allows an animated navigation between these pages.

readthedown format

Adapted from the corresponding readtheorg theme of the org-html-themes project, fully responsive with dynamic table of contents and collapsible navigation.

html_clean format

Simple and clean template with dynamic table of contents, very similar to the one from the great knitrBootstrap package by Jim Hester.

html_docco format

Simple template, no table of contents. CSS heavily inspired from the default one of the docco project.

Features and helpers

Some extra features are available depending on the format :

The package also provides a create.doc() function as well as RStudio document templates to easily generate an empty and ready to use rmarkdown file with several configuration directives.

Finally, it also provides the pilltabs() helper function, which allows to display a crosstab dynamically. See one of the output samples for a live example.


You can install the latest stable release from CRAN :


Or the latest development snapshot from GitHub :

install.packages(devtools)  # if necessary

Creating a new document

Within RStudio

Choose File > New File... > R Markdown..., then select From Template. You should then be able to create a new document from one of the package templates.

Without RStudio

The create.doc() function allows you to create a new directory with a clean ready-to-use RMarkdown file. create.doc() gets two main arguments :

By default, a Makefile file will be created in the new folder for direct rendering from the command line.


With RStudio

Rendering from within RStudio should be quite simple : just click the Knit button.

Rendering from R

You can render your document into HTML directly from within R with the render() function from the rmarkdown package :


Rendering with the Makefile

If you created your .Rmd file with the create.doc() function, you can then generate HTML or PDF files with :

make html
make pdf

You can also clean out any generated files and cache with :

make clean


The html_clean styling and features are very similar to the ones from the great knitrBootstrap package by Jim Hester.