added note about pygment example code and markdown processing, updated e...

...xample

Added a note about markdown and code handling and Github flavored Markdown and more standard Markdown, as much as there is one, explanations.

Added the Github flavored Markdown code fences to the example so that it can be copied and pasted with it working.