KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

nabla.nvim

★ 747 Open GitHub ↗

take your scientific notes :pencil2: in Neovim

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

nabla.nvim
-----------

Take your scentific notes in Neovim.

The colorscheme used here is [tokyonight](https://github.com/folke/tokyonight.nvim).

An ASCII math generator from LaTeX equations.

Requirements
------------

* Neovim nightly
* A colorscheme which supports treesitter [see here](https://github.com/rockerBOO/awesome-neovim#tree-sitter-supported-colorscheme) _(*)_
* Tree-sitter : [nvim-treesitter/nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter) _(*)_
  (Not a dependency, but recommended to install parsers).
* Latex parser : Install with `TSInstall latex` _(*)_

_(*): Skip when using LazyVim_

Install
-------

<details>
  <summary>Using <a href="https://github.com/junegunn/vim-plug">vim-plug</a></summary>

```vim
  Plug 'jbyuki/nabla.nvim'
  ```
</details>

<details>
  <summary>Using <a href="https://github.com/wbthomason/packer.nvim">packer.nvim</a></summary>

```vim
  use 'jbyuki/nabla.nvim'
  ```
</details>

<details>
  <summary>Using <a href="https://github.com/LazyVim/LazyVim">lazy.vim</a></summary>

```lua
    {
        "williamboman/mason.nvim",
        opts = { ensure_installed = { "tree-sitter-cli" } },
    },

{
        "jbyuki/nabla.nvim",
        dependencies = {
            "nvim-neo-tree/neo-tree.nvim",
            "williamboman/mason.nvim",
        },
        lazy = true,

config = function()
            require("nvim-treesitter.configs").setup({
                ensure_installed = { "latex" },
                auto_install = true,
                sync_install = false,
            })
        end,

keys = function()
            return {
                {
                    "<leader>p",
                    ':lua require("nabla").popup()<cr>',
                    desc = "NablaPopUp",
                },
            }
        end,
    },

```
</details>

<details>
  <summary>Using the built-in package manager</summary>

* Create a folder `pack/<a folder name of your choosing>/start`
  * Inside the `start` folder `git clone` nabla.nvim
    * `git clone https://github.com/jbyuki/nabla.nvim`
  * In your init.lua, add the pack folder to packpath (see `:help packpath`)
    ```lua
    vim.o.packpath = vim.o.packpath .. ",<path to where pack/ is located>"
    ```

* `git pull` in the plugin folder to update it. You want something more viable
  though, that's why package managers are useful.
</details>

Configuration
-------------

_(Default keymap to nabla-render in LazyVim is `<leader>p`)_

Bind the following command:

```vim
nnoremap <leader>p :lua require("nabla").popup()<CR> " Customize with popup({border = ...})  : `single` (default), `double`, `rounded`
```

See [here](https://github.com/jbyuki/nabla.nvim/issues/35) for virt_lines support.

Usage
-----

* Press <kbd>leader + p</kbd> while the cursor is on a math expression to open floating menu

Reference
---------

See [test/input.txt](https://github.com/jbyuki/nabla.nvim/blob/master/test/input.txt) for examples.

**Note**: If the notation you need is not present or there is a misaligned expression, feel free to open an [Issue](https://github.com/jbyuki/nabla.nvim/issues).

Credits
-------

* Thanks to jetrosut for his helpful feedback and bug troubleshoot.
* Thanks to nbCloud91 for pointing me to VIM conceals.
* Thanks to clstb for giving suggestions on how to enhance the interaction.
* Thanks to aspeddro for adding preview popups.
* Thanks to Areustle for adding more than 500 new symbols.
* Thanks to kkharji for pointing out virt_lines.
* Thanks to max397574 for a proper treesitter implementation.

Contribute
----------

See [here](https://github.com/jbyuki/ntangle.nvim/wiki/How-to-use-ntangle.nvim).

nabla.nvim

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README