Fixed linebreaks in markdown docs

Markdown transforms linebreaks into `<br>` which is not what we need in the middle of sentences. You could use `max-length` in CSS to limit the line length if needed.