use consistent heading markdown, add note for grid class generation