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

[github-actions]

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment or this will be closed in 14 days