amend documentation for correct md (markdown) format