doc: markup improvements