@@ -901,7 +901,10 @@ Options affecting specific writers
901901
902902`--listings`
903903
904−: Use the [`listings`] package for LaTeX code blocks
904+: Use the [`listings`] package for LaTeX code blocks. The package
905+ does not support multi-byte encoding for source code. To handle UTF-8
906+ you would need to use a custom template. This issue is fully
907+ documented here: [Encoding issue with the listings package].
905908
906909`-i`, `--incremental`
907910
@@ -1129,6 +1132,8 @@ Options affecting specific writers
11291132
11301133[Dublin Core elements]: http://dublincore.org/documents/dces/
11311134[ISO 8601 format]: http://www.w3.org/TR/NOTE-datetime
1135+[Encoding issue with the listings package]:
1136+ https://en.wikibooks.org/wiki/LaTeX/Source_Code_Listings#Encoding_issue
11321137
11331138Citation rendering
11341139------------------