Apply consistent formatting for markdown files

[paskal]

Add a bunch of newlines where it is appropriate and stick to formatting with no line breaks as we don't have them in most of the existing documentation, making the markdown files more consistent.

Also, indent embedded yaml files with two spaces for better readability.