amend documentation for correct md (markdown) formatw