How to convert R Markdown to HTML? I.e., What does “Knit HTML” do in Rstudio 0.96?

by

Basic Script

So now that the R markdown package has been released, here is some code to replicate the features of Knit to Html.

require(knitr) # required for knitting from rmd to md
require(markdown) # required for md to html 
knit('test.rmd', 'test.md') # creates md file
markdownToHTML('test.md', 'test.html') # creates html file
browseURL(paste('file://', file.path(getwd(),'test.html'), sep='')) # open file in browser

where test.rmd is the name of your R markdown file.
Note that I’m not 100% confident about the browseURL line (hence my question here about opening files in a web browser).

markdownToHTML Options

The good thing about markdownToHTML is that there are heaps of options in how the HTML is created (see ?markdownHTMLOptions). So for example, if you want just a code fragment without all the header information, you could write:

markdownToHTML('test.md', 'test.html', options="fragment_only")

or if you don’t like hard wrapping (i.e., inserting line breaks when there are single manual line breaks in the markdown source), you can omit the ‘hard_wrap’ option.

# The default options are 'hard_wrap', 'use_xhtml', 
#      'smartypants', and 'base64_images'.
markdownToHTML('test.md', 'test.html', 
       options=c('use_xhtml', 'base64_images'))

Makefile

This could also all be added to a makefile perhaps using Rscript -e (e.g., something like this). Here’s a basic example makefile I put together, where test indicates that the rmd file is called test.rmd.

RMDFILE=test

html :
    Rscript -e "require(knitr); require(markdown); knit('$(RMDFILE).rmd', '$(RMDFILE).md'); markdownToHTML('$(RMDFILE).md', '$(RMDFILE).html', options=c('use_xhtml', 'base64_images')); browseURL(paste('file://', file.path(getwd(),'$(RMDFILE).html'), sep=''))"

The makefile uses my preferred markdown options: i.e., options=c('use_xhtml', 'base64_images')

More Related Contents:

  1. Rstudio rmarkdown: both portrait and landscape layout in a single PDF
  2. two-column layouts in RStudio presentations/slidify/pandoc
  3. R – Markdown avoiding package loading messages
  4. YAML current date in rmarkdown
  5. Difference: “Compile PDF” button in RStudio vs. knit() and knit2pdf()
  6. knitr/rmarkdown/Latex: How to cross-reference figures and tables?
  7. Generate Dynamic R Markdown Blocks
  8. Conditionally display a block of text in R Markdown
  9. Align multiple tables side by side
  10. Programmatically creating Markdown tables in R with KnitR
  11. Code chunk font size in Rmarkdown with knitr and latex
  12. R knitr Markdown: Output Plots within For Loop
  13. Split the title onto multiple lines?
  14. How to add table of contents in Rmarkdown?
  15. Create a loop that includes both a code chunk and text
  16. How to hold figure position with figure caption in pdf output of knitr?
  17. Insert a logo in upper right corner of R markdown pdf document
  18. Use loop to generate section of text in rmarkdown
  19. Use R code or Windows user variable (“%userprofile%”) in YAML?
  20. In RStudio/RMarkdown, how to setwd?
  21. possible to create latex multicolumns in xtable?
  22. How to stop bookdown tables from floating to bottom of the page in pdf?
  23. Unicode with knitr and Rmarkdown
  24. Plot size and resolution with R markdown, knitr, pandoc, beamer
  25. Programmatically insert header and plot in same code chunk with R markdown using results=’asis’
  26. New R-Studio version 0.98.932 deletes .md file – how to prevent?
  27. Reduce file size of R Markdown HTML output
  28. Wrap text around plots in Markdown
  29. sample function gives different result in console and in knitted document when seed is set
  30. Automatically adjust LaTeX table width to fit pdf using knitr and Rstudio

Leave a Comment