Create an introduction page?

In addition to the module-documentation pages generated by the pdoc command-line utility, I would like to create an introduction page for the distribution package as a whole (as opposed to the import packages / modules), which describes the different modules in context.

pdoc has no option to do, and I've seen the issues where corresponding requests have been denied by the author. I therefore intend to do so myself, using the programmatic API of the pdoc module. Unfortunately, I cannot quite figure out how to do it.

The idea would be to

• have a Markdown text for the page, e.g. read from a file
• create an HTML document in the same style as the pdoc-generated pages, i.e. optimally using the same templates.

It would be great if you could give me some pointers!

Start by examining the pdoc command-line utility and the programmatic API of the pdoc module to understand how module documentation is generated. The requested result is a Markdown-backed introduction page for the distribution package, rendered as an HTML document using the same style or templates as generated pages.