Rename README to README.md and fix it to make it  pretty-printed

* [Github Flavored Markdown](https://help.github.com/articles/github-flavored-markdown) is used
* The rendered result of the markdown can be seen from https://github.com/kmizu/scala-migrations/tree/fix-readme