Generate Academic Posters in R Markdown and CSS, inspired by 'reveal.js'
Switch branches/tags
Nothing to show
Clone or download
bbucior Fix minor bugs from over-general rules
I found some more special cases in code tags and figure captions while
working on a new poster.  This commit fixes those artifacts.  For
example, the default Rmd (which includes R code) had angle brackets
around the code summary(cars).
Latest commit ba73616 Oct 19, 2018

drposter: Generate Academic Posters in R Markdown and CSS

Ben Bucior1, <Your name here>2

  1. Northwestern University, Evanston, IL, USA

  2. Earth


  • Template for writing HTML/CSS posters using Rmarkdown
  • Same conventions as pandoc presentations (e.g. reveal.js)1–3
  • Separates content from presentation
  • Goal: automatically get consistent spacing from specifications instead of a manual layout

Rmarkdown structure

See also the source code and compiled pdf for this poster on Github.

title: Title of your document within R Markdown's YAML header
output: drposter::drposter_poster

# {.col-3}
## Overall document columns (`<h1>`)

Content is organized using headers as sections.  Level 1 sections
define the overall layout of subblocks.  Use the `.col-x` class to
use x columns for subblocks.

## Another left column block

You can place multiple subblocks within the same overall .col-x,
for example to get a 3-column layout like this example code here.

# {.col-3}
## Individual content blocks (`<h2>`)

Actual content goes within the level 2 blocks, which have two inner
columns by default, e.g. for figures.


Most of the markdown commands seem to work, though there are
probably still some that are untested.

# {.col-3}
## Use this div to automatically write your references to a section:

<div id="refs" class="references"></div>


3rd party

  • Package inspired by reveal.js presentation framework1 and its R package2
  • Fonts under their respective licenses
  • Logo: thanks to Openclipart for the CC0 graduation cap image, hexSticker for sticker generation, and bcbioSmallRna for a helpful sticker example
  • See and the CSL project4 for more info about citation options (CC BY SA 3.0)

This package


QR code For more information, please visit the project page at Feel free to report issues, pull requests, or general comments on Github.

How to use this package

Installation and updates

  1. devtools::install_github("bbucior/drposter", dep=FALSE) (or install_local on a downloaded copy) to install/update the package
  2. In RStudio, you can find the format listed as a template under the “New R Markdown” wizard, or use the command line.
  3. Template files are cached in drposter_files/ to decouple your poster from the installed package version. Use drposter_update to resync them.

Customizing the template

  • Avoid modifying drposter_files/
  • Indirectly override those rules in your own custom.css or equivalent
    • Easier to see and share your changes
    • Decouples your modifications from the base drposter styles
  • Customize the format of the bibliography5,6 using a CSL style4


  • View and “print as PDF” from Chrome7
  • Be sure to save a PDF (and possibly html with self_contained: true) to archive your project at the end, in case there are changes in pandoc, rmarkdown, etc.
  • You can also render the poster in other formats, such as a github_document or revealjs::revealjs_presentation

Reproducible research

Directly include plots

Directly include stats

##      speed           dist       
##  Min.   : 4.0   Min.   :  2.00  
##  1st Qu.:12.0   1st Qu.: 26.00  
##  Median :15.0   Median : 36.00  
##  Mean   :15.4   Mean   : 42.98  
##  3rd Qu.:19.0   3rd Qu.: 56.00  
##  Max.   :25.0   Max.   :120.00

Customizable themes

Note the features for theming. If you had a special class attached to the .level1 or .slides/theme, you could use a general descendent selector to automatically get theming support, then break up these details into separate theme files.

Default theme

This is an example of the default theme.

Minimalist theme

This is an example of the minimalist theme.

See also