Rework docstring to markdown converter

[jakebailey]

For #424. See also #422, #17, #444.

RestTextConverter worked by doing some amount of ReST parsing, but isn't always correct in all cases.

It may be worthwhile to use an actual ReST parser (perhaps an existing grammar).