/dev/api: Document how listings work.
/dev/api: Improve documentation for GET_comments.
/dev/api: Fully document the "subreddits" section.
/dev/api: Use markdown for overview text.

This improves styling consistency and makes the source easier to edit.
Yay.