Fixed some issues that came to light while compiling documentation for the python bindings.
The Python documentation generator (branch) uses the same markdown library as is used with gi-docgen.
Helps: #3250