doc: markdown: massive improvements.