Hi, good question.
There is a module meant for this exact purpose. I am sure you have heard of it, it's called Sphinx.
So what Sphinx does is that it will automatically generate documents for you as __doc__ and autodoc. Cool, right?
Did you know that even the official documentation page of Python actually used Sphinx?
Similar to the markdown text we have the reStructedText here. But it is not every time that you will prefer restructured text right?
For this exact purpose, you can use pdoc if you want to prefer Markdown text.
Hope this helps!