Formatting Python argparse help is awful. It requires hacking through debris of interwined code - see techtonik/suxx#1 for details.
The solution is to try to create data format for command line help that could be easily rendered with Jinja2 template.