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
Merge pull request #5 from dvarrazzo/readme

Readme properly converted to reST