Fixup README so it renders as markdown.

[baptr]

• Rename to README.md.
• Use #-style headers.
• Fix lists and codeblocks.
• Backtick paths and commands.
• Link to examples files.
• Link to godoc for package dependencies.