In parsermd: Formal Parser and Related Tools for R Markdown Documents

Include external images

You can call the function knitr::include_graphics() in a code chunk to embed external images. This function works for all types of knitr source documents, such as Rnw and Rmd. Below is a simple example:

library(knitr)
include_graphics('figure/003-minimal-html-cars-scatter-2.png', dpi = NA)

You can pass a character vector of mutiple image paths to include_graphics(), and you can also use chunk options related to figures, such as out.width and fig.cap, etc.

Some tests

Below are some tests for the PR https://github.com/yihui/knitr/pull/1776.

Three graphics in the same chunk

# A hack that you should not look at!
knitr::opts_knit$set(rmarkdown.pandoc.to = 'html')

images = c(
  "figure/001-minimal-unnamed-chunk-2-1.png",
  "figure/001-minimal-unnamed-chunk-2-2.png",
  "figure/003-minimal-html-cars-scatter-2.png"
)

Using three times include_graphics():

knitr::include_graphics(images[1])
knitr::include_graphics(images[2])
knitr::include_graphics(images[3])

knitr::include_graphics(images)

Mixing with R plots

knitr::include_graphics(images[1])
plot(cars)
knitr::include_graphics(images[2])
1 + 1
knitr::include_graphics(images[3])

knitr::include_graphics(images[1:2])
plot(cars)
1 + 1
knitr::include_graphics(images[3])

Placing caption at the top

knitr::include_graphics(images[1])
knitr::include_graphics(images[2])
knitr::include_graphics(images[3])

knitr::include_graphics(images)

parsermd documentation built on May 20, 2021, 5:08 p.m.