Markdown header entity definition clarified

Including some minor typo fixes