Use markdown, fix badge, and document local override files