[DOC] Use more effective markdown syntax in README

@martindale asked feedback on pain-points I found in the official node.js client library. The pull request includes suggested changes to the README markdown to make the API more quickly qrokkable.