[Sphinx docs as markdown] Parse autodoc as markdown #sphinx

docstrings.py

# based on https://stackoverflow.com/a/56428123/23972
import commonmark


def docstring(app, what, name, obj, options, lines):
    if len(lines) > 1 and lines[0] == "@&ismd":
        md = "\n".join(lines[1:])
        ast = commonmark.Parser().parse(md)
        rst = commonmark.ReStructuredTextRenderer().render(ast)
        lines.clear()
        lines += rst.splitlines()


def setup(app):
    app.connect("autodoc-process-docstring", docstring)