Feature/modify python examples docgen

A few suggestions for modifications of the markdown generator, separated into small commits. This way we could easily cherry-pick some of the suggestions if we want them.