updating markdown - suppress warning, etc.