code review changes part 1
added markdown elements and fixed tests