@@ -449,7 +449,8 @@ General writer options
449449
450450: Specifies the coloring style to be used in highlighted source code.
451451 Options are `pygments` (the default), `kate`, `monochrome`,
452− `espresso`, `zenburn`, `haddock`, and `tango`.
452+ `espresso`, `zenburn`, `haddock`, and `tango`. For more information
453+ on syntax highlighting in pandoc, see [Syntax highlighting], below.
453454
454455`-H` *FILE*, `--include-in-header=`*FILE*
455456
@@ -1422,6 +1423,8 @@ word.
14221423
14231424To prevent all highlighting, use the `--no-highlight` flag.
14241425To set the highlighting style, use `--highlight-style`.
1426+For more information on highlighting, see [Syntax highlighting],
1427+below.
14251428
14261429Line blocks
14271430-----------
@@ -3312,6 +3315,24 @@ ordinary HTML (without bird tracks).
33123315writes HTML with the Haskell code in bird tracks, so it can be copied
33133316and pasted as literate Haskell source.
33143317
3318+Syntax highlighting
3319+===================
3320+
3321+Pandoc will automatically highlight syntax in fenced code blocks that
3322+are marked with a language name. (See [Extension:
3323+`inline_code_attributes`] and [Extension: `fenced_code_attributes`],
3324+above.) The Haskell library [highlighting-kate] is used for
3325+highlighting, which works in HTML, Docx, and LaTeX/PDF output.
3326+The color scheme can be selected using the `--highlight-style` option.
3327+The default color scheme is `pygments`, which imitates the default color
3328+scheme used by the Python library pygments, but pygments is not actually
3329+used to do the highlighting.
3330+
3331+To see a list of language names that pandoc will recognize, type
3332+`pandoc --version`.
3333+
3334+To disable highlighting, use the `--no-highlight` option.
3335+
33153336Custom writers
33163337==============
33173338
@@ -3499,3 +3520,4 @@ Wikiwide.
34993520[EPUBspine]: http://www.idpf.org/epub/301/spec/epub-publications.html#sec-spine-elem
35003521[KaTeX]: https://github.com/Khan/KaTeX
35013522[CommonMark]: http://commonmark.org
3523+[highlighting-kate]: http://github.com/jgm/highlighting-kate