bluetex 0.6.2

Clean up your LaTeX files.

Fork Notice

Bluetex is a fork of the original Blacktex project by Nico Schlömer. The original project moved to a non-public development style, so this fork was created to continue public development under the name "Bluetex" to avoid confusion with the original project.

• Original author: Nico Schlömer (up to commit 9df96918bd9075ddd659a9e272e16c6426011e31, 2022-02-16)
• Fork maintainer: David Völgyes (from 2025 onwards)
• Original project: https://github.com/texworld/blacktex/

Bluetex is a command-line tool that helps with article editing in LaTeX. It removes all comments from a given file and corrects some common anti-patterns.

Usage

Run the package directly with uvx:

uvx bluetex in.tex > out.tex

For example, this input file

Because   of $$a+b=c$$ ({\it Pythogoras}),
% @johnny remember to insert name
and $y=2^ng$ with $n=1,...,10$, we have ${\Gamma \over 2}=8.$

is converted to

Because of
\[
a+b = c
\]
(\textit{Pythogoras}),
and \(y = 2^n g\) with \(n = 1,\dots,10\), we have \(\frac{\Gamma}{2} = 8\).

You can use

uvx bluetex -i in0.tex in1.tex ...

to modify files in-place. See uvx bluetex --help for all options.

Pre-commit hooks

You can clean LaTeX files automatically before committing them to git.

repos:
- repo: https://github.com/dvolgyes/bluetex
  rev: v0.6.2
  hooks:
  - id: bluetex

The hook runs bluetex --in-place on staged .tex files.

License

This software is published under the GPLv3 license.