Note

This documentation is for a development version of IPython. There may be significant differences from the latest stable release (1.2.1).

Module: nbconvert.utils.pandoc

Utility for calling pandoc

1 Class

class IPython.nbconvert.utils.pandoc.PandocMissing(*args, **kwargs)

Bases: IPython.nbconvert.utils.exceptions.ConversionException

Exception raised when Pandoc is missing.

__init__(*args, **kwargs)

4 Functions

IPython.nbconvert.utils.pandoc.pandoc(source, fmt, to, extra_args=None, encoding='utf-8')

Convert an input string in format from to format to via pandoc.

Parameters:

source : string

Input string, assumed to be valid format from.

fmt : string

The name of the input format (markdown, etc.)

to : string

The name of the output format (html, etc.)

Returns:

out : unicode

Output as returned by pandoc.

Raises:

PandocMissing

If pandoc is not installed.

Any error messages generated by pandoc are printed to stderr.

IPython.nbconvert.utils.pandoc.get_pandoc_version()

Gets the Pandoc version if Pandoc is installed.

If the minimal version is not met, it will probe Pandoc for its version, cache it and return that value. If the minimal version is met, it will return the cached version and stop probing Pandoc (unless clean_cache() is called).

Raises:

PandocMissing

If pandoc is unavailable.

IPython.nbconvert.utils.pandoc.check_pandoc_version()

Returns True if minimal pandoc version is met.

Raises:

PandocMissing

If pandoc is unavailable.

IPython.nbconvert.utils.pandoc.clean_cache()