Improve README.md.

Use code syntax when possible and be consistent with the headers syntax.
Tweak demo files.