fix link in readme
markdown issues
better config explanation
typos
last markdown fix