Edits to markdown

[kappapiana]

There are a couple of markdown glitches in the document I have been reading, please consider adopting the changes.

Thanks

[kappapiana]

I also advise to add a YAML preamble with the copyright, license and authorship in each file. YAML is not rendered in any interpreter and adds some useful machine-readable fields and meta information. Better if it's in SPDX format