doc: improvements to buffer.markdown copy

General improvements to buffer.markdown including new examples,
a few fixes to existing examples, consistent formatting and
others

PR-URL: nodejs#4370
Reviewed-By: Trevor Norris <[email protected]>

Author: jasnell