docs: add documentation for syntax highlighting

[youkwhd]

should the example be as is, or replace it with actual Pygments? thanks :-)

[yogthos]

I think it's probably fine as is, it gives an idea of how to use the feature. Thanks for the docs update!