Pygments FAQ

What is Pygments?

Pygments is a syntax highlighting engine written in Python. That means, it willtake source code (or other markup) in a supported language and output aprocessed version (in different formats) containing syntax highlighting markup.

Its features include:

  • a wide range of commonlanguages and markup formats is supported

  • new languages and formats are added easily

  • a number of output formats is available, including:

    • HTML

    • ANSI sequences (console output)

    • LaTeX

    • RTF

  • it is usable as a command-line tool and as a library

  • parsing and formatting is fast

Pygments is licensed under the BSD license.

Where does the name Pygments come from?

Py of course stands for Python, whilepigments are used for coloring paint,and in this case, source code!

What are the system requirements?

Pygments only needs a standard Python install. No additional libraries are needed.

How can I use Pygments?

Pygments is usable as a command-line tool as well as a library.

From the command-line, usage looks like this (assuming the pygmentize script isproperly installed):

pygmentize-fhtml/path/to/file.py

This will print a HTML-highlighted version of /path/to/file.py to standard output.

For a complete help, please runpygmentize-h.

Usage as a library is thoroughly demonstrated in the Documentation section.

How do I make a new style?

Please see thedocumentation on styles.

How can I report a bug or suggest a feature?

Please report bugs and feature wishes in the tracker at GitHub.

You can also e-mail the authors, see the contact details.

I want this support for this language!

Instead of waiting for others to include language support, why not write ityourself? All you have to know isoutlined in the docs.

Can I use Pygments for programming language processing?

The Pygments lexing machinery is quite powerful can be used to build lexers forbasically all languages. However, parsing them is not possible, though somelexers go some steps in this direction in order to e.g. highlight function namesdifferently.

Also, error reporting is not the scope of Pygments. It focuses on correctlyhighlighting syntactically valid documents, not finding and compensating errors.

Who uses Pygments?

This is an (incomplete) list of projects and sites known to use the Pygments highlighter.

  • Wikipedia

  • BitBucket, a Mercurial and Git hosting site

  • The Sphinx documentation builder, for embedded source examples

  • rst2pdf, a reStructuredText to PDF converter

  • Codecov, a code coverage CI service

  • Trac, the universal project management tool

  • AsciiDoc, a text-based documentation generator

  • ActiveState Code, the Python Cookbook successor

  • ViewVC, a web-based version control repository browser

  • BzrFruit, a Bazaar branch viewer

  • QBzr, a cross-platform Qt-based GUI front end for Bazaar

  • Review Board, a collaborative code reviewing tool

  • Diamanda, a Django powered wiki system with support for Pygments

  • Progopedia (English),an encyclopedia of programming languages

  • Bruce, a reStructuredText presentation tool

  • PIDA, a universal IDE written in Python

  • BPython, a curses-based intelligent Python shell

  • PuDB, a console Python debugger

  • XWiki, a wiki-based development framework in Java, using Jython

  • roux, a script for running R scriptsand creating beautiful output including graphs

  • hurl, a web service for making HTTP requests

  • wxHTMLPygmentizer isa GUI utility, used to make code-colorization easier

  • Postmarkup, a BBCode to XHTML generator

  • WpPygments, andWPygments, highlighter plugins for WordPress

  • Siafoo, a tool for sharing and storing useful code and programming experience

  • D source, a community for the D programming language

  • dpaste.com, another Django pastebin

  • Django snippets, a pastebin for Django code

  • Fayaa, a Chinese pastebin

  • Incollo.com, a free collaborative debugging tool

  • PasteBox, a pastebin focused on privacy

  • hilite.me, a site to highlight code snippets

  • patx.me, a pastebin

  • Fluidic, an experiment inintegrating shells with a GUI

  • pygments.rb, a pygments wrapper for Ruby

  • Clygments, a pygments wrapper forClojure

  • PHPygments, a pygments wrapper for PHP

  • Spyder, the Scientific Python DevelopmentEnvironment, uses pygments for the multi-language syntax highlighting in itseditor.

  • snippet.host, minimal text and code snippet hosting

  • sourcehut, the hacker’s forge

  • Material for MkDocs, popular static site generator

If you have a project or web site using Pygments,open an issue or PR and we’ll add a line here.