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)