Tweaking the README to provide MD context

Instead of marking all things as code, lean on Github's pygments
parsing of markdown to indicate the type of code.
Cleaning up documentation and usage

Attempting to express intent in the documentation as well as in the
variable naming.