improve rendering of code on the index page

- style highlighted code blocks with darker background and border
- fix whitespace problems / invalid html on code blocks on the homepage
- update readme to remove warning about issues