getting the markdown right