News for hackers. Stuff that matters.
Re:Don’t Use Markdown for Documentation by dunham on Tuesday March 15, 2016 @05:02PM (#11292973)
it can be a pain to rewrite that into rst.

If you just want to rewrite markdown into rst, "pandoc" will do the trick.

Re:Don’t Use Markdown for Documentation by ajford on Tuesday March 15, 2016 @08:53PM (#11294193)
True. But that's not always all that's needed. If I decide to flesh out an API section, it would be better to put the work in and use autodoc (which of course means I have to go make sure my docstrings are up to date). Build a TOC. A lot of things in RST are not in Markdown (the whole point of this article), and would have to be added to really take advantage of RST.