Standard formatting for documentation comments?

[cblake]

The documentation already supports cross-linking/hyper references. For example, 
[this](https://nim-lang.org/docs/tables.html) is generated from the source code 
in stdlib's `tables.nim`. I believe it is a dialect of reStructuredText not 
markdown.