Update README.md

Howdy, saw this in the Postgres Weekly email and figured I'd help out. :grinning: 

--
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.