updating remarks in markdown