@@ -4624,9 +4624,9 @@ Syntax highlighting
46244624
46254625Pandoc will automatically highlight syntax in [fenced code blocks] that
46264626are marked with a language name. The Haskell library [skylighting] is
4627−used for highlighting, which works in HTML, Docx, Ms, and LaTeX/PDF output.
4628−To see a list of language names that pandoc will recognize, type
4629−`pandoc --list-highlight-languages`.
4627+used for highlighting. Currently highlighting is supported only for
4628+HTML, EPUB, Docx, Ms, and LaTeX/PDF output. To see a list of language names
4629+that pandoc will recognize, type `pandoc --list-highlight-languages`.
46304630
46314631The color scheme can be selected using the `--highlight-style` option.
46324632The default color scheme is `pygments`, which imitates the default color
@@ -4634,6 +4634,24 @@ scheme used by the Python library pygments (though pygments is not actually
46344634used to do the highlighting). To see a list of highlight styles,
46354635type `pandoc --list-highlight-styles`.
46364636
4637+If you are not satisfied with the predefined styles, you can
4638+use `--print-highlight-style` to generate a JSON `.theme` file which
4639+can be modified and used as the argument to `--highlight-style`. To
4640+get a JSON version of the `pygments` style, for example:
4641+
4642+ pandoc --print-highlight-style pygments > my.theme
4643+
4644+Then edit `my.theme` and use it like this:
4645+
4646+ pandoc --highlight-style my.theme
4647+
4648+If you are not satisfied with the built-in highlighting, or you
4649+want highlight a language that isn't supported, you can use the
4650+`--syntax-definition` option to load a [KDE-style XML syntax definition
4651+file](https://docs.kde.org/stable5/en/applications/katepart/highlight.html).
4652+Before writing your own, have a look at KDE's [repository of syntax
4653+definitions](https://github.com/KDE/syntax-highlighting/tree/master/data/syntax).
4654+
46374655To disable highlighting, use the `--no-highlight` option.
46384656
46394657[skylighting]: https://github.com/jgm/skylighting