doc: markdown fixups
Merge pull request #1 from sbinet/master

doc updates