How can I use both Sphinx and Pycco for Python documentation?

Question

I'd like to be able to use Sphinx for the main project documentation, so the docstrings must be in reStructuredText, but I'd also like to generate HTML for reading the inline comments in the style of Pycco, which uses Markdown.

Is there a tool or combination of tools that will allow me to do convert only the docstrings from reStructuredText to Markdown?

Answer 1

A software called Pandoc may be the right tool. You can see the detail in the page through the hyperlink. I ever wanted to have try of it, but it needs Haskell runtime environment which is a little big, so I gave up.

Answer 2

The pyment tool can convert docstrings to different formats. You could start with that, and then write a subclass of DocToolsBase to format docstrings the way you like.

See this question What is the standard Python docstring format? for more about python docstring conventions and tooling.