remove markdown mishaps, added syntax highlighting
Merge pull request #1 from jtmoulia/docs-rst-tweaks

remove markdown mishaps, added syntax highlighting