Docutils can do Markdown, too

Tony Narlock <[email protected]>
Newsgroups gmane.text.docutils.user
Message-ID <CAC8GGzO0PwqscPyFfmQeLyu=D6bRAKmgXb+KXvua59DAeLQNJw@mail.gmail.com>
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!

------------------------------------------------------------------------------
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.