\usepackage{latexindent}
Comment formater et embellir du code LaTeX
Un code source LaTeX désordonné est difficile à lire, encore plus à déboguer et pénible à partager. Formater vos fichiers .tex avec une indentation cohérente et une structure claire facilite tout. Ce guide vous montre comment formater du code LaTeX en ligne avec le formateur gratuit de FormaTeX, propulsé par latexindent , sans aucune installation.
Que vous nettoyiez une thèse avant de la soumettre, que vous imposiez un style commun à un article rédigé par plusieurs auteurs ou que vous souhaitiez simplement rendre votre code plus lisible, un formateur LaTeX vous évite de le faire à la main. Collez votre code, cliquez sur Formater et copiez le résultat.
\section{Pourquoi formater}
Pourquoi formater du code LaTeX ?
LaTeX est un langage de balisage et, comme pour tout balisage, le fichier source peut vite devenir difficile à parcourir si la mise en forme est incohérente. Contrairement au résultat compilé, vous passez la plupart de votre temps devant la source : sa lisibilité influence donc directement votre productivité. Voici les quatre grandes raisons de garder votre code LaTeX bien formaté.
Lisibilité
Properly indented LaTeX code lets you see the document structure at a glance. When every \begin and \end pair is visually aligned, you can instantly tell which content belongs to which environment. This is especially important in long documents with deeply nested structures like figures inside subfigures inside columns.
Collaboration
Lorsque plusieurs auteurs travaillent sur le même fichier .tex, les incohérences de mise en forme s'accumulent vite. L'un utilise une indentation de deux espaces, un autre des tabulations et un troisième aucune indentation. Un standard de formatage partagé, appliqué par un outil, met fin aux discussions de style et garde des différences propres dans le contrôle de version.
Débogage
The most common LaTeX errors are mismatched braces and missing \end tags. When your code is properly formatted, these problems become visually obvious. An \end{itemize} that is not at the same indentation level as its \begin{itemize} immediately stands out. Without formatting, you are left counting braces by hand.
Cohérence
Les revues, les universités et les groupes de recherche ont souvent des consignes de style pour le code source LaTeX. Un formateur vous permet d'appliquer ces règles automatiquement à chaque fichier d'un projet, de sorte que votre code source ait le même aspect qu'il ait été écrit par un étudiant de première année ou par un chercheur confirmé.
\section{Pas à pas}
Pas à pas : formater avec FormaTeX
FormaTeX exécute latexindent côté serveur : vous n'avez donc besoin d'installer ni Perl, ni TeX Live, ni aucune dépendance sur votre machine. L'ensemble du processus prend quelques secondes, quelle que soit la taille du fichier.
Collez votre code LaTeX
Open the FormaTeX LaTeX Formatter tool and paste your unformatted .tex source code into the editor panel on the left. The tool accepts any valid LaTeX — full documents with \documentclass, standalone environments, or even single fragments like a tabular block. There is no file size limit for the free tier, so you can paste an entire thesis chapter if needed.
Vous pouvez aussi saisir directement dans l'éditeur si vous écrivez du nouveau LaTeX de zéro et souhaitez qu'il soit formaté au fur et à mesure.
Cliquez sur Formater
Press the Format button to send your code to the FormaTeX server. The formatter runs latexindent with sensible defaults: it normalizes indentation to consistent spacing, aligns \begin and \end delimiters, removes trailing whitespace, and applies clean brace placement. The operation typically completes in under a second — you will see the formatted output appear in the right panel immediately.
Le formateur conserve vos commentaires et ne modifie aucune commande LaTeX ni aucun contenu. Il ne change que les espaces et l'indentation.
Copiez le résultat formaté
Examinez le code LaTeX proprement formaté dans le panneau de sortie. Le formateur met en évidence les changements pour que vous voyiez exactement ce qui a été modifié. Quand vous êtes satisfait, cliquez sur le bouton de copie pour placer le code formaté dans votre presse-papiers, puis collez-le dans votre éditeur, qu'il s'agisse de VS Code, d'Overleaf, de TeXstudio ou de l'éditeur en ligne de FormaTeX. Vous pouvez aussi télécharger directement le fichier formaté.
Si vous travaillez en équipe, envisagez d'exécuter le formateur avant chaque commit pour garder votre dépôt propre et des différences minimales.
\section{Sous le capot}
Ce que latexindent fait sous le capot
Le formateur de FormaTeX repose sur latexindent , le script Perl de référence pour le formatage de code source LaTeX. Il est inclus dans toutes les distributions TeX Live et MiKTeX récentes, et c'est le même outil que celui utilisé par des éditeurs comme VS Code (via l'extension LaTeX Workshop) et TeXstudio pour le formatage automatique.
Lorsque vous cliquez sur Formater dans FormaTeX, votre code est envoyé à un serveur qui exécute une installation TeX Live complète. Le serveur appelle latexindent avec une configuration par défaut qui couvre la grande majorité des cas d'usage. Il traite votre code en une seule passe et renvoie le résultat : votre code source n'est jamais écrit sur disque et est effacé de la mémoire immédiatement après le formatage.
Les principales opérations de latexindent sont les suivantes : normaliser les niveaux d'indentation de tous les environnements, aligner les balises \begin et \end , supprimer les espaces en fin de ligne, uniformiser l'usage des lignes vides entre les paragraphes et garantir un placement cohérent des accolades et des crochets autour des arguments de commande. Il comprend les constructions propres à LaTeX comme les conditionnelles \if...\fi , les délimiteurs du mode mathématique et les environnements verbatim (qui restent intacts).
\section{Bonnes pratiques}
Bonnes pratiques de formatage
Un formateur s'occupe du travail mécanique, mais connaître les principes d'un bon formatage LaTeX vous aidera à écrire du code plus propre dès le départ. Ces bonnes pratiques valent que vous utilisiez FormaTeX, une installation locale de latexindent ou un formatage manuel.
Utilisez une indentation cohérente
Choisissez deux ou quatre espaces par niveau d'indentation et tenez-vous-y dans tout votre projet. Indentez le contenu de chaque environnement : document, figure, table, itemize, enumerate, equation et align. La seule exception est l'environnement document lui-même, que certains auteurs choisissent de ne pas indenter pour éviter de décaler tout le contenu d'un niveau. Quelle que soit la convention choisie, appliquez-la de façon uniforme.
\begin{itemize}
\item First item
\item Second item
\begin{itemize}
\item Sub-item
\end{itemize}
\end{itemize}Imbriquez correctement les environnements
Every \begin must have a matching \end at the same indentation level. When environments are nested — a tabular inside a table inside a figure, for example — each level should be indented one step further. This visual nesting makes it trivial to spot mismatched or missing delimiters. If you find yourself more than four or five levels deep, consider extracting the inner content into a separate \input file.
\begin{figure}[h]
\centering
\begin{tabular}{lc}
\toprule
Name & Score \\
\midrule
Alice & 95 \\
\bottomrule
\end{tabular}
\caption{Results}
\end{figure}Écrivez des commentaires utiles
Use comments to explain why, not what. A comment like "% begin table" above a \begin{table} adds nothing. A comment like "% Grade distribution for Fall 2025 cohort" tells a co-author what the table represents. Place section-level comments on their own line, and use end-of-line comments sparingly. Keep comments at the same indentation level as the code they describe.
% Grade distribution for Fall 2025 cohort
\begin{table}[h]
\centering
\begin{tabular}{lc}
...
\end{tabular}
\end{table}Maîtrisez la longueur des lignes
Gardez les lignes en dessous de 80 à 100 caractères. Les lignes longues sont difficiles à lire, produisent des différences bruyantes dans le contrôle de version et gênent l'édition côte à côte. Coupez les longues phrases à des endroits naturels : après la ponctuation ou entre deux propositions. Pour les longs arguments de commande, placez chaque argument sur sa propre ligne. Le compilateur LaTeX ignore les simples retours à la ligne au sein d'un paragraphe : couper les lignes n'affecte donc pas le résultat.
% Bad: one very long line
\caption{The relationship between input voltage and output current measured across a 10k ohm resistor at room temperature}
% Good: broken at natural points
\caption{
The relationship between input voltage
and output current measured across
a 10k ohm resistor at room temperature
}\section{Avant et après}
Avant et après le formatage
Voici un exemple concret de ce que fait le formateur FormaTeX sur un fichier LaTeX typiquement désordonné. Le contenu est identique : seuls les espaces et l'indentation changent.
\begin{document} \begin{figure}[h] \centering \includegraphics[width=0.8\textwidth]{chart.png} \caption{Quarterly results for 2025. This chart shows revenue growth.} \label{fig:chart} \end{figure} \begin{table}[h] \centering \begin{tabular}{lcc} \toprule Quarter & Revenue & Growth \\ \midrule Q1 & \$120k & 12\% \\ Q2 & \$145k & 21\% \\ Q3 & \$132k & -9\% \\ \bottomrule \end{tabular} \caption{Revenue by quarter} \end{table} \end{document}\begin{document} \begin{figure}[h] \centering \includegraphics[width=0.8\textwidth]{chart.png} \caption{ Quarterly results for 2025. This chart shows revenue growth. } \label{fig:chart} \end{figure} \begin{table}[h] \centering \begin{tabular}{lcc} \toprule Quarter & Revenue & Growth \\ \midrule Q1 & \$120k & 12\% \\ Q2 & \$145k & 21\% \\ Q3 & \$132k & -9\% \\ \bottomrule \end{tabular} \caption{Revenue by quarter} \end{table} \end{document}Remarquez que chaque environnement est indenté d'un niveau à l'intérieur de son parent. La commande \caption avec un long argument est répartie sur plusieurs lignes. Des lignes vides séparent les blocs logiques. Le contenu et les commandes sont inchangés : seule la structure est clarifiée.
\section{Quand formater}
Quand devez-vous formater votre LaTeX ?
Il n'y a pas de mauvais moment pour formater, mais certains moments sont plus utiles que d'autres. Formatez votre code avant de le valider dans le contrôle de version : vos différences git porteront ainsi sur le contenu plutôt que sur du bruit d'espaces. Formatez avant de soumettre un article à une revue, pour que les relecteurs et les typographes voient une source propre. Formatez lorsque vous recevez un fichier co-rédigé par quelqu'un d'autre, afin d'harmoniser son style avec le vôtre.
Si vous utilisez l'API FormaTeX, vous pouvez intégrer le formatage dans un pipeline CI/CD ou un hook de pré-commit. Ainsi, chaque fichier .tex de votre dépôt est automatiquement formaté avant d'atteindre la branche principale, à la manière de Prettier pour JavaScript ou de Black pour Python.
\section{Guides associés}
Guides et outils associés
Découvrez d'autres outils LaTeX et guides d'apprentissage sur FormaTeX.