move readme over to markdown

added examples and some useful content