I think this makes the doc clearer about markup