Have you considered the use of reStructuredText syntax to produce your
Just like epytext it can be used to produce API documentation
with Epydoc, but it is already geared towards the production of standalone
documents too (with titles, ToC, metadata etc.) and is ready to produce html,
pdf and some other fancy format.
Epydoc also contains a script - apirst2html.py - allowing a standalone reST
document to reference API docs generated with Epydoc itself, e.g. citing
:api:`some_function()` or :api:`module.Class`. The script converts the
document into HTML and links the objects marked with the above syntax to the
matching epydoc-generated API docs.