convert to GH flavored Markdown
clarify API key setup