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
- split code from text, in the usage section
- a couple other minor tweaks