Update README.md

More descriptive examples of highlighting of macros.
Also add references to some issues.