@@ -4624,9 +4624,9 @@ Syntax highlighting
4625Pandoc will automatically highlight syntax in [fenced code blocks] that
4625Pandoc will automatically highlight syntax in [fenced code blocks] that
4626are marked with a language name. The Haskell library [skylighting] is
4626are marked with a language name. The Haskell library [skylighting] is
4627+used for highlighting. Currently highlighting is supported only for
4627−used for highlighting, which works in HTML, Docx, Ms, and LaTeX/PDF output.
4628+HTML, EPUB, Docx, Ms, and LaTeX/PDF output. To see a list of language names
4628−To see a list of language names that pandoc will recognize, type
4629−`pandoc --list-highlight-languages`.
4629+that pandoc will recognize, type `pandoc --list-highlight-languages`.
4631The color scheme can be selected using the `--highlight-style` option.
4631The color scheme can be selected using the `--highlight-style` option.
4632The default color scheme is `pygments`, which imitates the default color
4632The 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
4634used to do the highlighting). To see a list of highlight styles,
4634used to do the highlighting). To see a list of highlight styles,
4635type `pandoc --list-highlight-styles`.
4635type `pandoc --list-highlight-styles`.
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:
4642+ pandoc --print-highlight-style pygments > my.theme
4644+Then edit `my.theme` and use it like this:
4646+ pandoc --highlight-style my.theme
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).
4637To disable highlighting, use the `--no-highlight` option.
4655To disable highlighting, use the `--no-highlight` option.
4639[skylighting]: https://github.com/jgm/skylighting
4657[skylighting]: https://github.com/jgm/skylighting