Pydoc doesn't parse docstrings at all. Most Python docstrings are written in reStructuredText (definitely the case for the scientific Python ecosystem). For example, here's pydoc's docs for ...

This project aims to use the pydoc-markdown tool to convert Python code (primarily Unreal Engine Python API stubs) in the UnrealPythonAPI directory into Markdown format documentation. Through this ...

A new project from Read the Docs aims to automatically generate API documentation from code uploaded to the Python Package Index Read the Docs, a popular community-supported service for creating ...