Update README.md

Update formatting to remove lists, using markdown headers instead to improve readability. (As a bonus they are linkable).

Add GitHub style code fencing blocks to the ruby code.

Update the representation for returned values to use the # => convention to distinguish from comments.