better use of Markdown formatting

- better line wrapping for code editing
- include links to referred doc files
- move non-usage info to the description section
- de-indent text so that it doesn't show up as code
- a couple other minor tweaks