update README to markdown

Most of the README was already in markdown, replaced the `~` with`##` headers and the opening section with `#` header. Here is a screenshot or you can checkout the live formatted doc at https://github.com/schneems/flask.

![](http://cl.ly/image/1L241I0E3f0R/content.png)