Improve README formatting

* Use valid markdown for headers
* Use code tags instead of italics for object/param names
* Use a proper code block highlighted as Java for the sample