This is proposed as an alternative to #4, rather than escaping markdown we could validate the docstrings to make sure they won't break anything, then allow them to contain markdown.
This will benefit users, since they can make things italic, bold, add links, and so on.
