Radix for R Markdown

[This article was first published on RStudio Blog, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

Today we’re excited to announce Radix, a new R Markdown format optimized for scientific and technical communication. Features of Radix include:

Radix is based on the Distill web framework, which was originally created for use in the Distill Machine Learning Journal. Radix combines the technical authoring features of Distill with R Markdown.

Below we’ll demonstrate some of the key features of Radix. To learn more about installing and using Radix, check out the Radix for R Markdown website.

Figure layout

Radix provides many flexible options for laying out figures. While the main text column in Radix articles is relatively narrow (optimized for comfortable reading), figures can occupy a larger region. For example:

For figures you want to emphasize or that require lots of visual space, you can also create layouts that occupy the entire width of the screen:

Of course, some figures and notes are only ancillary and are therefore better placed in the margin:

Citations and metadata

Radix articles support including citations and a corresponding bibliography using standard R Markdown citation syntax.

In addition, when you provide a citation_url metadata field for your article, a citation appendix that makes it easy for others to cite your article is automatically generated:

Radix also automatically includes standard Open Graph and Twitter Card metadata. This makes links to your article display rich metadata when shared in various places:

Creating a blog

You can publish a series of Radix articles as either a website or a blog. For example, the TensorFlow for R blog is implemented using Radix:

To learn more, see the article on creating a blog with Radix.

Getting started

To create an R Markdown document that uses the Radix format, first install the radix R package:


Using Radix requires Pandoc v2.0 or higher. If you are using RStudio then you should use RStudio v1.2.718 or higher (which comes bundled with Pandoc v2.0). You can download the preview release of RStudio v1.2 at https://www.rstudio.com/products/rstudio/download/preview/.

Next, use the New R Markdown dialog within RStudio to create a new Radix article:

This will give you a minimal new Radix document.

Then, check out the Radix for R Markdown website to learn more about what’s possible. Happy authoring!

To leave a comment for the author, please follow the link and comment on their blog: RStudio Blog.

R-bloggers.com offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

Never miss an update!
Subscribe to R-bloggers to receive
e-mails with the latest R posts.
(You will not see this message again.)

Click here to close (This popup will not appear again)