R Markdown with the Docco Linear Style

This is an example of Markdown vignettes using the Docco style.

Docco

To use the Docco style for Markdown vignettes in an R package, you need to

add *.Rmd files under the vignettes directory
add Suggests: knitr and VignetteBuilder: knitr to the DESCRIPTION file
specify the vignette engine \VignetteEngine{knitr::docco_linear} in the Rmd files (inside HTML comments)

After building and installing the package, you can view vignettes via

browseVignettes(package = 'Your_Package')

Examples

Below are some code chunks as examples.

cat("_hello_ **markdown**!", "\n")

hello markdown!

Normally you do not need any chunk options.

1 + 1

## [1] 2

10:1

##  [1] 10  9  8  7  6  5  4  3  2  1

rnorm(5)^2

## [1] 2.36677 0.01204 0.26160 0.04578 0.03464

strsplit("hello, markdown vignettes", "")

## [[1]]
##  [1] "h" "e" "l" "l" "o" "," " " "m" "a" "r" "k" "d" "o" "w" "n" " " "v"
## [18] "i" "g" "n" "e" "t" "t" "e" "s"

Feel free to draw beautiful plots and write math \(P(X>x)=\alpha/2\).

n = 300
set.seed(123)
par(mar = c(4, 4, 0.1, 0.1))
plot(rnorm(n), rnorm(n), pch = 21, cex = 5 * runif(n), col = "white", bg = "gray")

plot of chunk unnamed-chunk-2

How does it work

The markdown package (>= v0.6.2) supports custom HTML templates, and the docco engine in knitr uses a custom template to compile Markdown to HTML:

knit2html(..., markdown.HTML.template = system.file("misc", "docco-template.html", 
    package = "knitr"))

That is it.