Fixed regressions in readme update.

Fixed regressions in the markdown syntax that happened in the last readme update. 
Also added some line breaks elsewhere to make it slightly easier to read.