sbahling / pyandoc

Python wrapper for Pandoc—the universal document converter.

Pyandoc: a simple Pandoc wrapper for Python

Requirements

• Pandoc

Usage

Get setup.

import pandoc

pandoc.PANDOC_PATH = '/usr/bin/pandoc'

Let's start with a Markdown document:

doc = pandoc.Document()
doc.markdown = '''
# I am an H1 Tag

* bullet point
* more points
* point with [link](http://kennethreitz.com)!
'''

Now let's convert that into a ReST document:

>>> print doc.rst

I am an H1 Tag
==============


-  bullet point
-  more points
-  point with `link <http://kennethreitz.com>`_!

Formats available:

• context
• docbook
• epub
• html
• html_lhs
• latex
• latex_lhs
• man
• markdow
• nmarkdown_lhs
• mediawiki
• native
• odt
• opendocument
• plain
• rst
• rst_lhs
• rtf
• s5
• slidy
• texinfo'

Enjoy.

Roadmap

• Cleanup
• Figure out epub, odt support
• Figure out better path management
• Proper Exceptions
• Unit testing
• CI