The readme is actually a reST file

Also fixed its syntax where broken.
Fixed project url
More idiomatic way to represent file names in the README