pandoc

0th

Percentile

A Pandoc wrapper to convert Markdown documents to other formats

This function calls Pandoc to convert Markdown documents to other formats such as HTML, LaTeX/PDF and Word, etc, (optionally) based on a configuration file or in-file configurations which specify the options to use for Pandoc.

Usage
pandoc(input, format, config = getOption("config.pandoc"), ext = NA, 
    encoding = getOption("encoding"))
Arguments
input
a character vector of the Markdown filenames
format
the output format (see References); it can be a character vector of multiple formats; by default, it is obtained from the t field in the configuration (if the configuration is empty or the t field is not found, the default output
config
the Pandoc configuration file; if missing, it is assumed to be a file with the same base name as the input file and an extension .pandoc (e.g. for foo.md it looks for foo.pandoc)
ext
the filename extensions; by default, the extension is inferred from the format, e.g. latex creates pdf, and dzslides creates html, and so on
encoding
the encoding of the input file; see file
Details

There are two ways to input the Pandoc configurations -- through a config file, or embed the configurations in the markdown file as special comments between .

The configuration file is a DCF file (see read.dcf). This file must contain a field named t which means the output format. The configurations are written in the form of tag:value and passed to Pandoc (if no value is needed, just leave it empty, e.g. the option standalone or s for short). If there are multiple output formats, write each format and relevant configurations in a block, and separate blocks with blank lines.

If there are multiple records of the t field in the configuration, the input markdown file will be converted to all these formats by default, unless the format argument is specified as one single format.

Value

  • The output filename(s) (or an error if the conversion failed).

References

Pandoc: http://johnmacfarlane.net/pandoc/; Examples and rules of the configurations: http://yihui.name/knitr/demo/pandoc

See Also

read.dcf

Aliases
  • pandoc
Examples
system("pandoc -h")  # see possible output formats
Documentation reproduced from package knitr, version 1.7, License: GPL

Community examples

Looks like there are no examples yet.