documentation: better syntax highlighting for yaml and shell

[nicolasochem]

I suspect that annotating code snippets with the desired syntax will be enough. Example: ```yaml