doc: tweak markdown quoting
doc: missing word in docstring
doc: tweak Markdown header syntax