nabla.nvim
An ASCII math generator from LaTeX equations for taking scientific notes in Neovim.
What is nabla.nvim?
nabla.nvim is a Neovim plugin that converts LaTeX mathematical expressions into ASCII art directly within the editor. It enables users to write and visualize scientific notes with proper mathematical notation without leaving their coding environment, using features like floating preview popups and tree-sitter integration.
Neovim users, particularly researchers, scientists, engineers, and students who write technical documentation or notes containing mathematical equations within Neovim.
It provides a minimalist, seamless integration into Neovim's ecosystem for rendering LaTeX equations as ASCII art, offering a lightweight alternative to external tools or heavy plugins, with accurate parsing via tree-sitter and customizable previews.
Overview
take your scientific notes :pencil2: in Neovim
Use Cases
Best For
- Writing scientific or mathematical notes in Neovim with inline LaTeX equation visualization.
- Previewing LaTeX equations as ASCII art in a floating window without switching applications.
- Integrating mathematical notation into code documentation or comments within Neovim.
- Using tree-sitter for accurate parsing and rendering of LaTeX expressions in Neovim.
- Customizing equation preview borders and display styles in a Neovim workflow.
- Displaying rendered equations as virtual lines in Neovim for enhanced readability.
Not Ideal For
- Users requiring high-fidelity, graphical equation rendering for publication-ready documents.
- Editors or environments outside of Neovim nightly with tree-sitter support.
- Projects needing a full LaTeX suite with compilation, bibliography management, or WYSIWYG editing.
Pros & Cons
Pros
Uses tree-sitter integration for precise parsing of LaTeX expressions, as highlighted in the README with recommendations to install the latex parser via `TSInstall latex`.
Offers floating preview popups and virt_lines support, blending into the Neovim workflow without requiring external applications or heavy plugins.
Supports different border styles for the preview window, such as single, double, or rounded, allowing users to tailor the visual appearance to their setup.
Follows a minimalist philosophy, providing essential LaTeX-to-ASCII conversion without bloating the editor, ideal for quick scientific note-taking in Neovim.
Cons
Requires Neovim nightly, which may be unstable or incompatible with some users' stable setups, limiting accessibility and increasing maintenance overhead.
Depends on tree-sitter, a latex parser, and specific colorschemes, adding multiple installation and configuration steps that can be cumbersome for newcomers.
Converts equations to ASCII art, which lacks the visual clarity and detail of proper LaTeX or graphical rendering, making it unsuitable for complex or dense mathematical expressions.
Frequently Asked Questions
Related Projects
neorgModernity meets insane extensibility. The future of organizing your life in Neovim.
orgmodeOrgmode clone written in Lua for Neovim 0.11.0+.
obsidian.nvimObsidian 🤝 Neovim (actively maintained version)
telekasten.nvimA Neovim (lua) plugin for working with a markdown zettelkasten / wiki and mixing it with a journal, based on telescope.nvim
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.