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 #83 from egli/master

Add source links to the API documentation
Merge pull request #84 from egli/feature/markdown-docstrings

Use markdown for the docstrings