[Docutils-users] Docutils can do Markdown, too

[Tony N. <to...@gi...>]

reStructuredText is covered by the Documentation Utilities.


What about Markdown? Docutils has all the tools needed to parse it, and
there is activity in the area.

A few years ago, remarkdown (https://github.com/sgenoud/remarkdown) sprung
up. As of this writing the last commit is Oct 14, 2014.

A new fork, recommonmark, implementing CommonMark (http://commonmark.org/)
specification of MarkDown emerged recently. You can try it out at
https://github.com/rtfd/recommonmark.

Both remarkdown and recommonmark return a docutils document tree (
http://docutils.sourceforge.net/docs/ref/doctree.html#document).

recommonmark is held with the ReadTheDocs project. Theoretically this could
give documentation writers the ability to use Markdown with sphinx.

There are exciting projects underway with docutils (including Kivy's
kiv.uix.rst module). It's a good time for docutils!