Markdown sections embedded docs

[crisrivlop]

Feature description:

Would it be great if markdown sections inside pydocs were able to use.

For example i am adding string docs to my python program and i wanted to describe the parameter list in a markdown table or if i wanted to add a markdown note (as GitHub note).

Problem and motivation:

I am very interested to document a python program using some sections written in markdown.

Is this something you're interesed in working on?

Yes

Additional notes:
This issue also will solve #82