texmagic.nvim

TeXMagic.nvim is a Neovim plugin designed to enhance the TexLab LSP server's build service by allowing dynamic selection of LaTeX build engines on a per-project basis. It solves the limitation of only being able to specify a global build engine in TexLab's configuration, making it ideal for users who work with multiple LaTeX projects requiring different compilation toolchains.

Key Features

• Magic Comment Detection — Reads %! TEX program = engine_name comments at the top of LaTeX documents to select the build engine.
• Custom Build Engines — Define any number of custom LaTeX build engines with specific executables and arguments in your Neovim configuration.
• Default Engine Fallback — Includes three default latexmk-based engines (pdflatex, xelatex, dvipspdf) and falls back to pdflatex if a requested engine isn't found.
• Seamless TexLab Integration — Provides a resolved build configuration that can be directly passed to the TexLab LSP server setup via nvim-lspconfig.
• Diagnostic Functions — Includes several Vim functions for troubleshooting, such as checking for magic comments, setup status, and selected program.

Philosophy

TeXMagic.nvim is built on simplicity and configurability, offering a lightweight solution to make TexLab's build service more flexible without the need for a full-featured plugin like Vimtex.