[TASK] Improve section about code samples

Show the possibility to highlight lines in code samples.
Improve description of advantages of using code-block.
Change link to pygment-supported languages to a more complete
resource.