fix typos / convert some links to markdown