I was thinking about rendering documentation for vars with Markdown. I just made some test code, and I can see it being really interesting (above, the text as is rendered today, below, the Markdown version):

The only problem is that there are some docstrings that get worse, like the one below. I think I'll add a toggle, so you can choose if you want Markdown or not: