Added languages to code blocks for syntax highlighting

Added languages to code blocks for syntax highlighting + moved the comments in the YAML example so that they don't overflow the page (and add a scrollbar).

(we can't see it in the diff but the syntax highlighting makes the code examples much more readable)
I think I had it like that before and it wasn't displayed correctly. Sure it works?