Use markdown for the doc strings

This allows for proper code blocks for the examples, courier font for
arguments, cross-referencing between functions, links to Java Classes
where appropriate, etc.
Merge pull request #84 from egli/feature/markdown-docstrings

Use markdown for the docstrings