An extremely fast LaTeX formatter written in Rust. Try it out now in your browser!

\documentclass{article}

\begin{document}

\begin{itemize}
\item Lists with items
over multiple lines
\end{itemize}

\begin{equation}
E = m c^2
\end{equation}

\end{document}

\documentclass{article}

\begin{document}

\begin{itemize}
  \item Lists with items
    over multiple lines
\end{itemize}

\begin{equation}
  E = m c^2
\end{equation}

\end{document}

• ⚡  Extremely fast run-time performance
• 🔧  Minimal configuration required
• 📟  Command line interface
• 📜  Handles LaTeX file types .tex, .bib, .cls, and .sty
• 🦀  Written entirely in safe Rust

Install the stable release with

cargo install tex-fmt

Install from GitHub with

cargo install --git "https://github.com/wgunderwood/tex-fmt"

Install from nixpkgs into a temporary shell with

nix-shell -p tex-fmt

Build from source using flakes with

nix build "github:wgunderwood/tex-fmt"

Add to your NixOS installation with

environment.systemPackages = [
  pkgs.tex-fmt
];

It is also included in treefmt-nix.

Install from the Arch User Repository. For example, using the yay AUR helper:

yay -S tex-fmt

Install from the Debian archive (trixie and later):

apt install tex-fmt

Install using Homebrew with

brew install tex-fmt

Binaries for various platforms are available on the GitHub releases page.

Integration with VS Code is provided by the LaTeX Workshop extension. You will need to first install tex-fmt through one of the above methods.

A package for Neovim is provided by mason.nvim.

The tex-fmt-action can install and run tex-fmt.

A package named latex-formatter is on CTAN.

The most commonly used options are given below. For a full list, see the options section below.

tex-fmt file.tex                   # format file.tex and overwrite
tex-fmt --check file.tex           # check if file.tex is correctly formatted
tex-fmt --print file.tex           # format file.tex and print to stdout
tex-fmt --recursive                # recursively format files in current directory
tex-fmt --recursive dir/           # recursively format files in dir
tex-fmt --fail-on-change file.tex  # format file.tex and return exit-code 1 if overwritten
tex-fmt --nowrap file.tex          # do not wrap long lines
tex-fmt --stdin                    # read from stdin and print to stdout
tex-fmt --help                     # view help information

Options can also be set using a configuration file, which will be read from the following locations, in order of decreasing priority.

• A named config file passed as tex-fmt --config <PATH>
• A file named tex-fmt.toml in the current working directory
• A file named tex-fmt.toml in the root directory of the current git repository
• A file named tex-fmt.toml in a subdirectory titled tex-fmt/ in the user's configuration directory
  • Linux: ~/.config/tex-fmt/tex-fmt.toml
  • macOS: /Users/<USER>/Library/Application Support/tex-fmt/tex-fmt.toml
  • Windows: C:\Users\<USER>\AppData\Roaming\tex-fmt\tex-fmt.toml

Arguments passed on the command line will always override those specified in configuration files. An example configuration file is available at tex-fmt.toml. To ignore all config files, use the --noconfig flag.

Note for contributors: this repository's configuration file will be automatically applied if tex-fmt is run from within the repository. Use --noconfig or --config <PATH> to avoid this.

Ending a source line with % tex-fmt: skip disables formatting for that line. To disable the formatter for a block, use % tex-fmt: off and % tex-fmt: on.

\documentclass{article}

\begin{document}

    This line is skipped % tex-fmt: skip

% tex-fmt: off
  These lines are also
    not formatted or wrapped
% tex-fmt: on

\end{document}

Verbatim environments including verbatim, Verbatim, lstlisting and minted are automatically skipped.

Recursive searches with --recursive or -r will ignore patterns in .gitignore and .ignore files, following git conventions.

Shell completion scripts can be generated at run-time using the --completion <SHELL> flag. See the completion directory for more details.

A man page can be generated at run-time using the --man flag. See the man directory for more details.

tex-fmt can be run before every git commit using pre-commit with the following .pre-commit-config.yaml in your repository root:

repos:
  - repo: https://github.com/WGUNDERWOOD/tex-fmt
    rev: v0.5.6
    hooks:
      - id: tex-fmt

To prevent the pre-commit hook from modifying your files, add:

      - id: tex-fmt
        args: [--check]

When formatting all of the test cases, tex-fmt is over a thousand times faster than latexindent.

Please feel free to open an issue or submit a pull request, including as much information as you can. Documentation of internals can be accessed by cloning this repository and running cargo doc, or by visiting the docs.rs page.

Alternatively, you can Buy Me a Coffee!

• Semantic parsing of LaTeX code not conducted
• No linting or correction of syntax errors
• Compliance with existing formatting guidelines not guaranteed
• No spelling or grammar checking

• latexindent. Perl script, many configuration options, slow on large files

• bibtex-tidy. JavaScript program, specifically for BibTeX files

• LaTeXTidy. Perl script, download links seem to be broken

• latex-pretty. Browser-based, uses latexindent as the backend

• latexformat.com. Browser-based

• texpretty. C program which works sometimes and appears to be fast

• latex-editor. Browser-based

• LaTeXFmt. Vim plugin, does not apply indentation

• latex-formatter. Visual Studio plugin, uses latexindent as the backend

• LLF. Lua script, many configuration options

The following arguments can be passed on the command line.

The following arguments can be provided in tex-fmt.toml. The first example in each row is the default value.