nbconvert: conversion utilities for the IPython notebook format
nbconvert provides command line utilities to convert to and from IPython notebooks and standard formats:
- Python script
As these tools mature, these utilities will be merged into IPython.
You will need the python markdown module
$ pip install markdown
as well as the latest development version of docutils. This can be installed via
$ curl http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar > docutils.tgz $ pip install -U docutils.tgz
Nbconvert also needs the pandoc multiformat converter to do the actual text conversions. Pandoc is included in most linux distributions package managers, and the author's website contains links to Mac OS X and Windows installers.
For conversion to HTML, pygments is also required
$ pip install pygments
$ pip install nose $ nosetests
You will need to either put the source repository in your
$PATH or symlink
nbconvert.py script, as well as the
to a directory in your
$PATH. Once this is done, you can call it as:
nbconvert -f <FORMAT> notebook.ipynb
nbconvert -h for up to date help on the available formats.