chroma

Chroma is a general-purpose syntax highlighting library and corresponding command, for Go.

Highlight a source file with Python lexer and output to terminal

$ chroma --lexer="[python]" [source_file]

Highlight a source file with the Go lexer and output to an HTML file

$ chroma --lexer="[go]" --formatter="[html]" [source_file] > [html_file]

Highlight a source file with the C++ lexer and output to an SVG, using the Monokai style

$ chroma --lexer="[c++]" --formatter="[svg]" --style="[monokai]" [source_file] > [svg_file]

chroma [options] files ...

This manual page documents briefly the chroma command.

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

–help: Show context-sensitive help.
–list: List lexers, styles and formatters.
–unbuffered: Do not buffer output.
–trace: Trace lexer states as they are traversed.
–check: Do not format, check for tokenization errors instead.
–filename=FILENAME: Filename to use for selecting a lexer when reading from stdin.
-l, –lexer=autodetect: Lexer to use when formatting.
-s, –style=swapoff: Style to use for formatting.
-f, –formatter=terminal: Formatter to use.
–html: Enable HTML mode (equivalent to `–formatter html').
–html-prefix=PREFIX: HTML CSS class prefix.
–html-styles: Output HTML CSS styles.
–html-only: Output HTML fragment.
–html-inline-styles: Output HTML with inline styles (no classes).
–html-tab-width=8: Set the HTML tab width.
–html-lines: Include line numbers in output.
–html-lines-table: Split line numbers and code in a HTML table
–html-lines-style=HTML-LINES-STYLE: Style for line numbers.
–html-highlight=N[:M][,...]: Highlight these lines.
–html-highlight-style=HTML-HIGHLIGHT-STYLE: Style used for highlighting lines.
–html-base-line=1: Base line number.
–version: Show application version.

See GitHub Issues: <https://github.com/alecthomas/chroma/issues>