a note about how to use markup