Use proper HTML comments as example marks in README

After this commit the "<!-- example --!>" won't get displayed
in the README.

This commit closes PR #26 by @igas.
Merge pull request #27 from splattael/readme-example

Use proper HTML comments as example marks in README