using pandoc instead of rst to document python

R. Michael Weylandt michael.weylandt at gmail.com
Tue Apr 23 18:40:31 EDT 2013


On Tue, Apr 23, 2013 at 6:36 PM, Peng Yu <pengyu.ut at gmail.com> wrote:
> Hi,
>
> I'm wondering if it possible to use pandoc instead of rst to document
> python. Is there a documentation system support this format of python
> document?

Pandoc is a converter while rst is a format so they're not directly
comparable; pandoc can convert _to_ and _from_ rst to a wide variety
of other formats, but you still have to write documentation in one
format or another. If you want to use an rst-centric documentation
tool, you can write in, e.g., Markdown, convert to rst and then run
your other tool on it.

Michael



More information about the Python-list mailing list