minted — highlighted source code for LaTeX

Current status

minted was created in 2009 by Konrad Rudolph. Geoffrey Poore agreed to take over minted maintenance in March of 2013, since his PythonTeX package also provides an interface to Pygments.

minted is currently in development for v2.0. The majority of planned features are already present in the current alpha release. During this time of transition, users who need maximum stability are encouraged to use minted 1.7 or PythonTeX. The release on CTAN will only be updated once v2.0 stabilizes.

New features in v2.0alpha (2013/07/30):

• Added the package option cache. This significantly increases compilation speed by caching old output. For example, compiling the documentation is around 5x faster.

• New inline command \mintinline. Custom versions can be created via \newmintinline. The command works inside other commands (for example, footnotes) in most situations, so long as the percent and hash characters are avoided.

• The new \setminted command allows options to be specified at the document and language levels.

• All extended characters (Unicode, etc.) supported by inputenc now work under the pdfTeX engine. This involved using \detokenize on everything prior to saving.

• New package option langlinenos allows line numbering to pick up where it left off for a given language when firstnumber=last.

• New options, including style, encoding, outencoding, codetagify, keywordcase, texcomments (same as texcl), python3 (for the PythonConsoleLexer), and numbers.

• \usemintedstyle now takes an optional argument to specify the style for a particular language, and works anywhere in the document.

• xcolor is only loaded if color isn’t, preventing potential package clashes.

Overview

minted is a LaTeX package that facilitates expressive syntax highlighting using the Pygments library. The package also provides options to customize the highlighted source code output using fancyvrb.

For instance, this code:

\begin{minted}[mathescape,
               linenos,
               numbersep=5pt,
               gobble=2,
               frame=lines,
               framesep=2mm]{csharp}
string title = "This is a Unicode π in the sky"
/*
Defined as $\pi=\lim_{n\to\infty}\frac{P_n}{d}$ where $P$ is the perimeter
of an $n$-sided regular polygon circumscribing a
circle of diameter $d$.
*/
const double pi = 3.1415926535
\end{minted}

will produce the following rendering:

See the documentation for examples and installation instructions.

Availability

minted is distributed with both TeX Live and MiKTeX. It is also available from CTAN. In any case, Python and Pygments need to be installed separately.

License

This work may be distributed and/or modified under the conditions of the LaTeX Project Public License (LPPL), version 1.3 or later.

Additionally, the project may be distributed under the terms of the 3-Clause ("New") BSD license.

Please use the project's GitHub site at https://github.com/gpoore/minted for suggestions, feature requests, and bug reports.