Searches for the pandoc executable in a few places and use the highest version found, unless a specific version is requested.

find_pandoc(cache = TRUE, dir = NULL, version = NULL)

Arguments

cache

Whether to search for pandoc again if a Pandoc directory containing the pandoc executable of the expected version (if provided) has been found previously. Search again if cache = FALSE.

dir

A character vector of potential directory paths under which pandoc may be found. If not provided, this function searches for pandoc from the environment variable RSTUDIO_PANDOC (the RStudio IDE will set this variable to the directory of Pandoc bundled with the IDE), the environment variable PATH, and the directory ~/opt/pandoc/.

version

The version of Pandoc to look for (e.g., "2.9.2.1"). If not provided, this function searches for the highest version under the potential directories.

Value

A list containing the directory and version of Pandoc (if found).

Note

Usually you do not need to install Pandoc if you use the RStudio IDE, because the IDE has bundled a version of Pandoc. If you have installed a version of Pandoc by yourself and want to use this version instead, you may use the dir argument of this function.

Examples

rmarkdown::find_pandoc()
#> $version
#> [1] ‘2.7.3’
#> 
#> $dir
#> [1] "/usr/bin"
#> 
rmarkdown::find_pandoc(dir = '~/Downloads/Pandoc')
#> $version
#> [1] ‘2.7.3’
#> 
#> $dir
#> [1] "/usr/bin"
#> 
rmarkdown::find_pandoc(version = '2.7.3')
#> $version
#> [1] ‘2.7.3’
#> 
#> $dir
#> [1] "/usr/bin"
#>