[Doc][Minor] Improve README.md

I've changed a bit `README.md` layout, I believe this improves readability significantly. You can check it out here [burkov/epgsql](https://github.com/burkov/epgsql/tree/improve_readmemd)

Also fixed typing in `pgsql.erl` and add few examples into `README.md`