readme: improve markdown and use long dashes.