Several small tweaks to README.md

- Added comments for input examples
- Tweaked comments for output examples
- Added markup under API section
- Linked “See Input/Output” sections 
- …Probably a few other minor edits I forgot