Fix escaping issues in the docs

Pandoc treats both underscores and dollar signs as non-literal
characters which screwed up the manpage.
Merge pull request #238 from mineo/man-fixes

Fix escaping issues in the man pages via pandoc generation. However this change introduces a few extra characters into README.md.