Make valid markdown and update documentation in README a bit
Fix trivial typo