updated docs with markdown formatting