Tentative doc update
Fixed char stripping of md files
updated README to support code correctly
Final commit before first PR
Various minor tweaks to README content on top of adinapoli's work
Shell snippet formatting

Adds syntax highlighting (via GitHub Markdown or Pandoc) and removes the
unnecessary leading `>`s in code blocks.
Documentation modernization and cleanup

Merge branch 'updated-docs'