[{"result":{"data":{"id":62,"owner":"nvim-treesitter","name":"nvim-treesitter","type":"github","source":"awesome-neovim","category":"syntax","link":"https://github.com/nvim-treesitter/nvim-treesitter","shortDescription":"Nvim Treesitter configurations and abstraction layer","createdAt":"2023-03-22T19:35:21.570Z","lastSyncedAt":"2023-06-04T18:09:28.472Z","stars":6999,"readme":"

nvim-treesitter

\n \n $\"Matrix$ \n \n \n $\"Linting$ \n \n \n $\"Syntax$ \n \n

\n\n

\n $\"Logo\"$ \n

\n Treesitter\n configurations and abstraction layer for\n Neovim.\n

\n \n Logo by @steelsojka\n \n

\n\nThe goal of `nvim-treesitter` is both to provide a simple and easy way to use the interface for [tree-sitter](https://github.com/tree-sitter/tree-sitter) in Neovim and to provide some basic functionality such as highlighting based on it:\n\n![example-cpp](https://user-images.githubusercontent.com/2361214/202753610-e923bf4e-e88f-494b-bb1e-d22a7688446f.png)\n\nTraditional highlighting (left) vs Treesitter-based highlighting (right).\nMore examples can be found in [our gallery](https://github.com/nvim-treesitter/nvim-treesitter/wiki/Gallery).\n\n**Warning: Treesitter and nvim-treesitter highlighting are an experimental feature of Neovim.\nPlease consider the experience with this plug-in as experimental until Tree-Sitter support in Neovim is stable!\nWe recommend using the nightly builds of Neovim if possible.\nYou can find the current roadmap [here](https://github.com/nvim-treesitter/nvim-treesitter/projects/1).\nThe roadmap and all features of this plugin are open to change, and any suggestion will be highly appreciated!**\n\nNvim-treesitter is based on three interlocking features: [**language parsers**](#language-parsers), [**queries**](#adding-queries), and [**modules**](#available-modules), where _modules_ provide features – e.g., highlighting – based on _queries_ for syntax objects extracted from a given buffer by _language parsers_.\nUsers will generally only need to interact with parsers and modules as explained in the next section.\nFor more detailed information on setting these up, see [\"Advanced setup\"](#advanced-setup).\n\n---\n\n### Table of contents\n\n- [Quickstart](#quickstart)\n- [Supported languages](#supported-languages)\n- [Available modules](#available-modules)\n- [Advanced setup](#advanced-setup)\n- [Extra features](#extra-features)\n- [Troubleshooting](#troubleshooting)\n\n---\n\n# Quickstart\n\n## Requirements\n\n- [Latest](https://github.com/neovim/neovim/releases/tag/stable) Neovim release ([nightly](https://github.com/neovim/neovim#install-from-source) recommended)\n- `tar` and `curl` in your path (or alternatively `git`)\n- A C compiler in your path and libstdc++ installed ([Windows users please read this!](https://github.com/nvim-treesitter/nvim-treesitter/wiki/Windows-support)).\n\n## Installation\n\nYou can install `nvim-treesitter` with your favorite package manager (or using the native `package` feature of vim, see `:h packages`).\n\n**NOTE: This plugin is only guaranteed to work with specific versions of language parsers** (as specified in the `lockfile.json`). **When upgrading the plugin, you must make sure that all installed parsers are updated to the latest version** via `:TSUpdate`.\nIt is strongly recommended to automate this; e.g., if you are using [vim-plug](https://github.com/junegunn/vim-plug), put this in your `init.vim` file:\n\n```vim\nPlug 'nvim-treesitter/nvim-treesitter', {'do': ':TSUpdate'}\n```\n\nFor other plugin managers such as `packer.nvim`, see this [Installation page from the wiki](https://github.com/nvim-treesitter/nvim-treesitter/wiki/Installation) (Note that this page is community maintained).\n\n## Language parsers\n\nTreesitter uses a different _parser_ for every language, which needs to be generated via `tree-sitter-cli` from a `grammar.js` file, then compiled to a `.so` library that needs to be placed in neovim's `runtimepath` (typically under `parser/{language}.so`).\nTo simplify this, `nvim-treesitter` provides commands to automate this process.\nIf the language is already [supported by `nvim-treesitter`](#supported-languages), you can install it with\n\n```vim\n:TSInstall \n```\n\nThis command supports tab expansion.\nYou can also get a list of all available languages and their installation status with `:TSInstallInfo`.\nParsers not on this list can be added manually by following the steps described under [\"Adding parsers\"](#adding-parsers) below.\n\nTo make sure a parser is at the latest compatible version (as specified in `nvim-treesitter`'s `lockfile.json`), use `:TSUpdate {language}`. To update all parsers unconditionally, use `:TSUpdate all` or just `:TSUpdate`.\n\n## Modules\n\nEach module provides a distinct tree-sitter-based feature such as [highlighting](#highlight), [indentation](#indentation), or [folding](#folding); see [`:h nvim-treesitter-modules`](doc/nvim-treesitter.txt) or [\"Available modules\"](#available-modules) below for a list of modules and their options.\n\nFollowing examples assume that you are configuring neovim with lua. If you are using vimscript, see `:h lua-heredoc`.\nAll modules are disabled by default and need to be activated explicitly in your `init.lua`, e.g., via\n\n```lua\nrequire'nvim-treesitter.configs'.setup {\n -- A list of parser names, or \"all\" (the five listed parsers should always be installed)\n ensure_installed = { \"c\", \"lua\", \"vim\", \"vimdoc\", \"query\" },\n\n -- Install parsers synchronously (only applied to `ensure_installed`)\n sync_install = false,\n\n -- Automatically install missing parsers when entering buffer\n -- Recommendation: set to false if you don't have `tree-sitter` CLI installed locally\n auto_install = true,\n\n -- List of parsers to ignore installing (for \"all\")\n ignore_install = { \"javascript\" },\n\n ---- If you need to change the installation directory of the parsers (see -> Advanced Setup)\n -- parser_install_dir = \"/some/path/to/store/parsers\", -- Remember to run vim.opt.runtimepath:append(\"/some/path/to/store/parsers\")!\n\n highlight = {\n enable = true,\n\n -- NOTE: these are the names of the parsers and not the filetype. (for example if you want to\n -- disable highlighting for the `tex` filetype, you need to include `latex` in this list as this is\n -- the name of the parser)\n -- list of language that will be disabled\n disable = { \"c\", \"rust\" },\n -- Or use a function for more flexibility, e.g. to disable slow treesitter highlight for large files\n disable = function(lang, buf)\n local max_filesize = 100 * 1024 -- 100 KB\n local ok, stats = pcall(vim.loop.fs_stat, vim.api.nvim_buf_get_name(buf))\n if ok and stats and stats.size > max_filesize then\n return true\n end\n end,\n\n -- Setting this to true will run `:h syntax` and tree-sitter at the same time.\n -- Set this to `true` if you depend on 'syntax' being enabled (like for indentation).\n -- Using this option may slow down your editor, and you may see some duplicate highlights.\n -- Instead of true it can also be a list of languages\n additional_vim_regex_highlighting = false,\n },\n}\n```\n\nEach module can also be enabled or disabled interactively through the following commands:\n\n```vim\n:TSBufEnable {module} \" enable module on current buffer\n:TSBufDisable {module} \" disable module on current buffer\n:TSEnable {module} [{ft}] \" enable module on every buffer. If filetype is specified, enable only for this filetype.\n:TSDisable {module} [{ft}] \" disable module on every buffer. If filetype is specified, disable only for this filetype.\n:TSModuleInfo [{module}] \" list information about modules state for each filetype\n```\n\nCheck [`:h nvim-treesitter-commands`](doc/nvim-treesitter.txt) for a list of all available commands.\nIt may be necessary to reload the buffer (e.g., via `:e`) after enabling a module interactively.\n\n# Supported languages\n\nFor `nvim-treesitter` to support a specific feature for a specific language requires both a parser for that language and an appropriate language-specific query file for that feature.\n\nThe following is a list of languages for which a parser can be installed through `:TSInstall`; a checked box means that `nvim-treesitter` also contains queries at least for the `highlight` module.\n\nExperimental parsers are parsers that have a maintainer but are not stable enough for\ndaily use yet.\n\nWe are looking for maintainers to add more parsers and to write query files for their languages. Check our [tracking issue](https://github.com/nvim-treesitter/nvim-treesitter/issues/2282) for open language requests.\n\n\n\n- [x] [ada](https://github.com/briot/tree-sitter-ada) (maintained by @briot)\n- [x] [agda](https://github.com/AusCyberman/tree-sitter-agda) (maintained by @Decodetalkers)\n- [x] [arduino](https://github.com/ObserverOfTime/tree-sitter-arduino) (maintained by @ObserverOfTime)\n- [x] [astro](https://github.com/virchau13/tree-sitter-astro) (maintained by @virchau13)\n- [ ] [awk](https://github.com/Beaglefoot/tree-sitter-awk)\n- [x] [bash](https://github.com/tree-sitter/tree-sitter-bash) (maintained by @TravonteD)\n- [x] [bass](https://github.com/amaanq/tree-sitter-bass) (maintained by @amaanq)\n- [x] [beancount](https://github.com/polarmutex/tree-sitter-beancount) (maintained by @polarmutex)\n- [x] [bibtex](https://github.com/latex-lsp/tree-sitter-bibtex) (maintained by @theHamsta, @clason)\n- [x] [bicep](https://github.com/amaanq/tree-sitter-bicep) (maintained by @amaanq)\n- [x] [blueprint](https://gitlab.com/gabmus/tree-sitter-blueprint.git) (experimental, maintained by @gabmus)\n- [x] [c](https://github.com/tree-sitter/tree-sitter-c) (maintained by @amaanq)\n- [x] [c_sharp](https://github.com/tree-sitter/tree-sitter-c-sharp) (maintained by @Luxed)\n- [x] [capnp](https://github.com/amaanq/tree-sitter-capnp) (maintained by @amaanq)\n- [x] [chatito](https://github.com/ObserverOfTime/tree-sitter-chatito) (maintained by @ObserverOfTime)\n- [x] [clojure](https://github.com/sogaiu/tree-sitter-clojure) (maintained by @sogaiu)\n- [x] [cmake](https://github.com/uyha/tree-sitter-cmake) (maintained by @uyha)\n- [x] [comment](https://github.com/stsewd/tree-sitter-comment) (maintained by @stsewd)\n- [x] [commonlisp](https://github.com/theHamsta/tree-sitter-commonlisp) (maintained by @theHamsta)\n- [x] [cooklang](https://github.com/addcninblue/tree-sitter-cooklang) (maintained by @addcninblue)\n- [x] [corn](https://github.com/jakestanger/tree-sitter-corn) (maintained by @jakestanger)\n- [x] [cpon](https://github.com/amaanq/tree-sitter-cpon) (maintained by @amaanq)\n- [x] [cpp](https://github.com/tree-sitter/tree-sitter-cpp) (maintained by @theHamsta)\n- [x] [css](https://github.com/tree-sitter/tree-sitter-css) (maintained by @TravonteD)\n- [x] [cuda](https://github.com/theHamsta/tree-sitter-cuda) (maintained by @theHamsta)\n- [x] [cue](https://github.com/eonpatapon/tree-sitter-cue) (maintained by @amaanq)\n- [x] [d](https://github.com/CyberShadow/tree-sitter-d) (experimental, maintained by @nawordar)\n- [x] [dart](https://github.com/UserNobody14/tree-sitter-dart) (maintained by @akinsho)\n- [x] [devicetree](https://github.com/joelspadin/tree-sitter-devicetree) (maintained by @jedrzejboczar)\n- [x] [dhall](https://github.com/jbellerb/tree-sitter-dhall) (maintained by @amaanq)\n- [x] [diff](https://github.com/the-mikedavis/tree-sitter-diff) (maintained by @gbprod)\n- [x] [dockerfile](https://github.com/camdencheek/tree-sitter-dockerfile) (maintained by @camdencheek)\n- [x] [dot](https://github.com/rydesun/tree-sitter-dot) (maintained by @rydesun)\n- [x] [ebnf](https://github.com/RubixDev/ebnf) (experimental, maintained by @RubixDev)\n- [x] [eex](https://github.com/connorlay/tree-sitter-eex) (maintained by @connorlay)\n- [x] [elixir](https://github.com/elixir-lang/tree-sitter-elixir) (maintained by @connorlay)\n- [x] [elm](https://github.com/elm-tooling/tree-sitter-elm) (maintained by @zweimach)\n- [x] [elsa](https://github.com/glapa-grossklag/tree-sitter-elsa) (maintained by @glapa-grossklag, @amaanq)\n- [x] [elvish](https://github.com/ckafi/tree-sitter-elvish) (maintained by @ckafi)\n- [ ] [embedded_template](https://github.com/tree-sitter/tree-sitter-embedded-template)\n- [x] [erlang](https://github.com/WhatsApp/tree-sitter-erlang) (maintained by @filmor)\n- [x] [fennel](https://github.com/travonted/tree-sitter-fennel) (maintained by @TravonteD)\n- [x] [firrtl](https://github.com/amaanq/tree-sitter-firrtl) (maintained by @amaanq)\n- [x] [fish](https://github.com/ram02z/tree-sitter-fish) (maintained by @ram02z)\n- [x] [foam](https://github.com/FoamScience/tree-sitter-foam) (experimental, maintained by @FoamScience)\n- [x] [fortran](https://github.com/stadelmanma/tree-sitter-fortran) (maintained by @amaanq)\n- [x] [fsh](https://github.com/mgramigna/tree-sitter-fsh) (maintained by @mgramigna)\n- [x] [func](https://github.com/amaanq/tree-sitter-func) (maintained by @amaanq)\n- [x] [fusion](https://gitlab.com/jirgn/tree-sitter-fusion.git) (maintained by @jirgn)\n- [x] [Godot (gdscript)](https://github.com/PrestonKnopp/tree-sitter-gdscript) (maintained by @PrestonKnopp)\n- [x] [git_config](https://github.com/the-mikedavis/tree-sitter-git-config) (maintained by @amaanq)\n- [x] [git_rebase](https://github.com/the-mikedavis/tree-sitter-git-rebase) (maintained by @gbprod)\n- [x] [gitattributes](https://github.com/ObserverOfTime/tree-sitter-gitattributes) (maintained by @ObserverOfTime)\n- [x] [gitcommit](https://github.com/gbprod/tree-sitter-gitcommit) (maintained by @gbprod)\n- [x] [gitignore](https://github.com/shunsambongi/tree-sitter-gitignore) (maintained by @theHamsta)\n- [x] [gleam](https://github.com/gleam-lang/tree-sitter-gleam) (maintained by @amaanq)\n- [x] [Glimmer and Ember](https://github.com/alexlafroscia/tree-sitter-glimmer) (maintained by @NullVoxPopuli)\n- [x] [glsl](https://github.com/theHamsta/tree-sitter-glsl) (maintained by @theHamsta)\n- [x] [go](https://github.com/tree-sitter/tree-sitter-go) (maintained by @theHamsta, @WinWisely268)\n- [x] [Godot Resources (gdresource)](https://github.com/PrestonKnopp/tree-sitter-godot-resource) (maintained by @pierpo)\n- [x] [gomod](https://github.com/camdencheek/tree-sitter-go-mod) (maintained by @camdencheek)\n- [x] [gosum](https://github.com/amaanq/tree-sitter-go-sum) (maintained by @amaanq)\n- [x] [gowork](https://github.com/omertuc/tree-sitter-go-work) (maintained by @omertuc)\n- [x] [graphql](https://github.com/bkegley/tree-sitter-graphql) (maintained by @bkegley)\n- [ ] [hack](https://github.com/slackhq/tree-sitter-hack)\n- [x] [hare](https://github.com/amaanq/tree-sitter-hare) (maintained by @amaanq)\n- [ ] [haskell](https://github.com/tree-sitter/tree-sitter-haskell)\n- [x] [hcl](https://github.com/MichaHoffmann/tree-sitter-hcl) (maintained by @MichaHoffmann)\n- [x] [heex](https://github.com/connorlay/tree-sitter-heex) (maintained by @connorlay)\n- [x] [hjson](https://github.com/winston0410/tree-sitter-hjson) (maintained by @winston0410)\n- [x] [hlsl](https://github.com/theHamsta/tree-sitter-hlsl) (maintained by @theHamsta)\n- [x] [hocon](https://github.com/antosha417/tree-sitter-hocon) (maintained by @antosha417)\n- [x] [html](https://github.com/tree-sitter/tree-sitter-html) (maintained by @TravonteD)\n- [x] [htmldjango](https://github.com/interdependence/tree-sitter-htmldjango) (experimental, maintained by @ObserverOfTime)\n- [x] [http](https://github.com/rest-nvim/tree-sitter-http) (maintained by @amaanq)\n- [x] [ini](https://github.com/justinmk/tree-sitter-ini) (experimental, maintained by @theHamsta)\n- [x] [ispc](https://github.com/fab4100/tree-sitter-ispc) (maintained by @fab4100)\n- [x] [janet_simple](https://github.com/sogaiu/tree-sitter-janet-simple) (maintained by @sogaiu)\n- [x] [java](https://github.com/tree-sitter/tree-sitter-java) (maintained by @p00f)\n- [x] [javascript](https://github.com/tree-sitter/tree-sitter-javascript) (maintained by @steelsojka)\n- [x] [jq](https://github.com/flurie/tree-sitter-jq) (maintained by @ObserverOfTime)\n- [x] [jsdoc](https://github.com/tree-sitter/tree-sitter-jsdoc) (maintained by @steelsojka)\n- [x] [json](https://github.com/tree-sitter/tree-sitter-json) (maintained by @steelsojka)\n- [x] [json5](https://github.com/Joakker/tree-sitter-json5) (maintained by @Joakker)\n- [x] [JSON with comments](https://gitlab.com/WhyNotHugo/tree-sitter-jsonc.git) (maintained by @WhyNotHugo)\n- [x] [jsonnet](https://github.com/sourcegraph/tree-sitter-jsonnet) (maintained by @nawordar)\n- [x] [julia](https://github.com/tree-sitter/tree-sitter-julia) (maintained by @theHamsta)\n- [x] [kdl](https://github.com/amaanq/tree-sitter-kdl) (maintained by @amaanq)\n- [x] [kotlin](https://github.com/fwcd/tree-sitter-kotlin) (maintained by @SalBakraa)\n- [x] [lalrpop](https://github.com/traxys/tree-sitter-lalrpop) (maintained by @traxys)\n- [x] [latex](https://github.com/latex-lsp/tree-sitter-latex) (maintained by @theHamsta, @clason)\n- [x] [ledger](https://github.com/cbarrete/tree-sitter-ledger) (maintained by @cbarrete)\n- [x] [llvm](https://github.com/benwilliamgraham/tree-sitter-llvm) (maintained by @benwilliamgraham)\n- [x] [lua](https://github.com/MunifTanjim/tree-sitter-lua) (maintained by @muniftanjim)\n- [x] [luadoc](https://github.com/amaanq/tree-sitter-luadoc) (maintained by @amaanq)\n- [x] [lua patterns](https://github.com/amaanq/tree-sitter-luap) (maintained by @amaanq)\n- [x] [luau](https://github.com/amaanq/tree-sitter-luau) (maintained by @amaanq)\n- [x] [m68k](https://github.com/grahambates/tree-sitter-m68k) (maintained by @grahambates)\n- [x] [make](https://github.com/alemuller/tree-sitter-make) (maintained by @lewis6991)\n- [x] [markdown (basic highlighting)](https://github.com/MDeiml/tree-sitter-markdown) (experimental, maintained by @MDeiml)\n- [x] [markdown_inline (needed for full highlighting)](https://github.com/MDeiml/tree-sitter-markdown) (experimental, maintained by @MDeiml)\n- [x] [matlab](https://github.com/mstanciu552/tree-sitter-matlab) (maintained by @amaanq)\n- [x] [menhir](https://github.com/Kerl13/tree-sitter-menhir) (maintained by @Kerl13)\n- [ ] [mermaid](https://github.com/monaqa/tree-sitter-mermaid) (experimental)\n- [x] [meson](https://github.com/Decodetalkers/tree-sitter-meson) (maintained by @Decodetalkers)\n- [x] [mlir](https://github.com/artagnon/tree-sitter-mlir) (experimental, maintained by @artagnon)\n- [ ] [nickel](https://github.com/nickel-lang/tree-sitter-nickel)\n- [x] [ninja](https://github.com/alemuller/tree-sitter-ninja) (maintained by @alemuller)\n- [x] [nix](https://github.com/cstrahan/tree-sitter-nix) (maintained by @leo60228)\n- [x] [norg](https://github.com/nvim-neorg/tree-sitter-norg) (maintained by @JoeyGrajciar, @vhyrro)\n- [x] [objc](https://github.com/amaanq/tree-sitter-objc) (maintained by @amaanq)\n- [x] [ocaml](https://github.com/tree-sitter/tree-sitter-ocaml) (maintained by @undu)\n- [x] [ocaml_interface](https://github.com/tree-sitter/tree-sitter-ocaml) (maintained by @undu)\n- [x] [ocamllex](https://github.com/atom-ocaml/tree-sitter-ocamllex) (maintained by @undu)\n- [x] [odin](https://github.com/amaanq/tree-sitter-odin) (maintained by @amaanq)\n- [ ] [org](https://github.com/milisims/tree-sitter-org)\n- [x] [pascal](https://github.com/Isopod/tree-sitter-pascal.git) (maintained by @Isopod)\n- [x] [passwd](https://github.com/ath3/tree-sitter-passwd) (maintained by @amaanq)\n- [x] [perl](https://github.com/ganezdragon/tree-sitter-perl) (maintained by @lcrownover)\n- [x] [php](https://github.com/tree-sitter/tree-sitter-php) (maintained by @tk-shirasaka)\n- [x] [phpdoc](https://github.com/claytonrcarter/tree-sitter-phpdoc) (experimental, maintained by @mikehaertl)\n- [x] [pioasm](https://github.com/leo60228/tree-sitter-pioasm) (maintained by @leo60228)\n- [x] [po](https://github.com/erasin/tree-sitter-po) (maintained by @amaanq)\n- [x] [Path of Exile item filter](https://github.com/ObserverOfTime/tree-sitter-poe-filter) (experimental, maintained by @ObserverOfTime)\n- [x] [pony](https://github.com/amaanq/tree-sitter-pony) (maintained by @amaanq, @mfelsche)\n- [x] [prisma](https://github.com/victorhqc/tree-sitter-prisma) (maintained by @elianiva)\n- [x] [proto](https://github.com/mitchellh/tree-sitter-proto) (maintained by @fsouza)\n- [x] [prql](https://github.com/PRQL/tree-sitter-prql) (maintained by @matthias-Q)\n- [x] [pug](https://github.com/zealot128/tree-sitter-pug) (experimental, maintained by @zealot128)\n- [x] [puppet](https://github.com/amaanq/tree-sitter-puppet) (maintained by @amaanq)\n- [x] [python](https://github.com/tree-sitter/tree-sitter-python) (maintained by @stsewd, @theHamsta)\n- [x] [ql](https://github.com/tree-sitter/tree-sitter-ql) (maintained by @pwntester)\n- [x] [qmldir](https://github.com/Decodetalkers/tree-sitter-qmldir) (maintained by @amaanq)\n- [x] [qmljs](https://github.com/yuja/tree-sitter-qmljs) (maintained by @Decodetalkers)\n- [x] [Tree-Sitter query language](https://github.com/nvim-treesitter/tree-sitter-query) (maintained by @steelsojka)\n- [x] [r](https://github.com/r-lib/tree-sitter-r) (maintained by @echasnovski)\n- [x] [racket](https://github.com/6cdh/tree-sitter-racket) (maintained by @6cdh)\n- [x] [rasi](https://github.com/Fymyte/tree-sitter-rasi) (maintained by @Fymyte)\n- [x] [regex](https://github.com/tree-sitter/tree-sitter-regex) (maintained by @theHamsta)\n- [x] [rego](https://github.com/FallenAngel97/tree-sitter-rego) (maintained by @FallenAngel97)\n- [x] [rnoweb](https://github.com/bamonroe/tree-sitter-rnoweb) (maintained by @bamonroe)\n- [x] [ron](https://github.com/amaanq/tree-sitter-ron) (maintained by @amaanq)\n- [x] [rst](https://github.com/stsewd/tree-sitter-rst) (maintained by @stsewd)\n- [x] [ruby](https://github.com/tree-sitter/tree-sitter-ruby) (maintained by @TravonteD)\n- [x] [rust](https://github.com/tree-sitter/tree-sitter-rust) (maintained by @amaanq)\n- [x] [scala](https://github.com/tree-sitter/tree-sitter-scala) (maintained by @stevanmilic)\n- [x] [scheme](https://github.com/6cdh/tree-sitter-scheme) (maintained by @6cdh)\n- [x] [scss](https://github.com/serenadeai/tree-sitter-scss) (maintained by @elianiva)\n- [x] [slint](https://github.com/jrmoulton/tree-sitter-slint) (experimental, maintained by @jrmoulton)\n- [x] [smali](https://git.sr.ht/~yotam/tree-sitter-smali) (maintained by @amaanq)\n- [x] [smithy](https://github.com/indoorvivants/tree-sitter-smithy) (maintained by @amaanq, @keynmol)\n- [x] [solidity](https://github.com/JoranHonig/tree-sitter-solidity) (maintained by @amaanq)\n- [x] [sparql](https://github.com/BonaBeavis/tree-sitter-sparql) (maintained by @BonaBeavis)\n- [x] [sql](https://github.com/derekstride/tree-sitter-sql) (maintained by @derekstride)\n- [x] [squirrel](https://github.com/amaanq/tree-sitter-squirrel) (maintained by @amaanq)\n- [x] [starlark](https://github.com/amaanq/tree-sitter-starlark) (maintained by @amaanq)\n- [x] [supercollider](https://github.com/madskjeldgaard/tree-sitter-supercollider) (maintained by @madskjeldgaard)\n- [x] [surface](https://github.com/connorlay/tree-sitter-surface) (maintained by @connorlay)\n- [x] [svelte](https://github.com/Himujjal/tree-sitter-svelte) (maintained by @elianiva)\n- [x] [swift](https://github.com/alex-pinkus/tree-sitter-swift) (maintained by @alex-pinkus)\n- [x] [sxhkdrc](https://github.com/RaafatTurki/tree-sitter-sxhkdrc) (maintained by @RaafatTurki)\n- [x] [t32](https://codeberg.org/xasc/tree-sitter-t32) (maintained by @xasc)\n- [x] [tablegen](https://github.com/amaanq/tree-sitter-tablegen) (maintained by @amaanq)\n- [x] [teal](https://github.com/euclidianAce/tree-sitter-teal) (maintained by @euclidianAce)\n- [x] [terraform](https://github.com/MichaHoffmann/tree-sitter-hcl) (maintained by @MichaHoffmann)\n- [x] [thrift](https://github.com/duskmoon314/tree-sitter-thrift) (maintained by @amaanq, @duskmoon314)\n- [x] [tiger](https://github.com/ambroisie/tree-sitter-tiger) (maintained by @ambroisie)\n- [x] [tlaplus](https://github.com/tlaplus-community/tree-sitter-tlaplus) (maintained by @ahelwer, @susliko)\n- [x] [todotxt](https://github.com/arnarg/tree-sitter-todotxt.git) (experimental, maintained by @arnarg)\n- [x] [toml](https://github.com/ikatyang/tree-sitter-toml) (maintained by @tk-shirasaka)\n- [x] [tsx](https://github.com/tree-sitter/tree-sitter-typescript) (maintained by @steelsojka)\n- [x] [turtle](https://github.com/BonaBeavis/tree-sitter-turtle) (maintained by @BonaBeavis)\n- [x] [twig](https://github.com/gbprod/tree-sitter-twig) (maintained by @gbprod)\n- [x] [typescript](https://github.com/tree-sitter/tree-sitter-typescript) (maintained by @steelsojka)\n- [x] [ungrammar](https://github.com/Philipp-M/tree-sitter-ungrammar) (maintained by @Philipp-M, @amaanq)\n- [x] [usd](https://github.com/ColinKennedy/tree-sitter-usd) (maintained by @ColinKennedy)\n- [x] [uxn tal](https://github.com/amaanq/tree-sitter-uxntal) (maintained by @amaanq)\n- [x] [v](https://github.com/vlang/vls) (maintained by @kkharji)\n- [x] [vala](https://github.com/vala-lang/tree-sitter-vala) (maintained by @Prince781)\n- [x] [verilog](https://github.com/tree-sitter/tree-sitter-verilog) (maintained by @zegervdv)\n- [x] [vhs](https://github.com/charmbracelet/tree-sitter-vhs) (maintained by @caarlos0)\n- [x] [vim](https://github.com/neovim/tree-sitter-vim) (maintained by @clason)\n- [x] [vimdoc](https://github.com/neovim/tree-sitter-vimdoc) (maintained by @clason)\n- [x] [vue](https://github.com/ikatyang/tree-sitter-vue) (maintained by @WhyNotHugo)\n- [x] [wgsl](https://github.com/szebniok/tree-sitter-wgsl) (maintained by @szebniok)\n- [x] [wgsl_bevy](https://github.com/theHamsta/tree-sitter-wgsl-bevy) (maintained by @theHamsta)\n- [x] [yaml](https://github.com/ikatyang/tree-sitter-yaml) (maintained by @stsewd)\n- [x] [yang](https://github.com/Hubro/tree-sitter-yang) (maintained by @Hubro)\n- [x] [yuck](https://github.com/Philipp-M/tree-sitter-yuck) (maintained by @Philipp-M, @amaanq)\n- [x] [zig](https://github.com/maxxnino/tree-sitter-zig) (maintained by @maxxnino)\n\n\nFor related information on the supported languages, including related plugins, see [this wiki page](https://github.com/nvim-treesitter/nvim-treesitter/wiki/Supported-Languages-Information).\n\n# Available modules\n\nModules provide the top-level features of `nvim-treesitter`.\nThe following is a list of modules included in `nvim-treesitter` and their configuration via `init.lua` (where multiple modules can be combined in a single call to `setup`).\nNote that not all modules work for all languages (depending on the queries available for them).\nAdditional modules can be provided as [external plugins](https://github.com/nvim-treesitter/nvim-treesitter/wiki/Extra-modules-and-plugins).\n\n#### Highlight\n\nConsistent syntax highlighting.\n\n```lua\nrequire'nvim-treesitter.configs'.setup {\n highlight = {\n enable = true,\n -- Setting this to true will run `:h syntax` and tree-sitter at the same time.\n -- Set this to `true` if you depend on 'syntax' being enabled (like for indentation).\n -- Using this option may slow down your editor, and you may see some duplicate highlights.\n -- Instead of true it can also be a list of languages\n additional_vim_regex_highlighting = false,\n },\n}\n```\n\nTo customize the syntax highlighting of a capture, simply define or link a highlight group of the same name:\n\n```lua\n-- Highlight the @foo.bar capture group with the \"Identifier\" highlight group\nvim.api.nvim_set_hl(0, \"@foo.bar\", { link = \"Identifier\" })\n```\n\nFor a language-specific highlight, append the name of the language:\n\n```lua\n-- Highlight @foo.bar as \"Identifier\" only in Lua files\nvim.api.nvim_set_hl(0, \"@foo.bar.lua\", { link = \"Identifier\" })\n```\n\nSee `:h treesitter-highlight-groups` for details.\n\n#### Incremental selection\n\nIncremental selection based on the named nodes from the grammar.\n\n```lua\nrequire'nvim-treesitter.configs'.setup {\n incremental_selection = {\n enable = true,\n keymaps = {\n init_selection = \"gnn\", -- set to `false` to disable one of the mappings\n node_incremental = \"grn\",\n scope_incremental = \"grc\",\n node_decremental = \"grm\",\n },\n },\n}\n```\n\n#### Indentation\n\nIndentation based on treesitter for the `=` operator.\n**NOTE: This is an experimental feature**.\n\n```lua\nrequire'nvim-treesitter.configs'.setup {\n indent = {\n enable = true\n }\n}\n```\n\n#### Folding\n\nTree-sitter based folding. _(Technically not a module because it's per windows and not per buffer.)_\n\n```vim\nset foldmethod=expr\nset foldexpr=nvim_treesitter#foldexpr()\nset nofoldenable \" Disable folding at startup.\n```\n\nThis will respect your `foldminlines` and `foldnestmax` settings.\n\n# Advanced setup\n\n## Changing the parser install directory\n\nIf you want to install the parsers to a custom directory you can specify this\ndirectory with `parser_install_dir` option in that is passed to `setup`.\n`nvim-treesitter` will then install the parser files into this directory.\n\nThis directory must be writeable and must be explicitly added to the\n`runtimepath`. For example:\n\n```lua\n vim.opt.runtimepath:append(\"/some/path/to/store/parsers\")\n\n require'nvim-treesitter.configs'.setup {\n parser_install_dir = \"/some/path/to/store/parsers\",\n\n ...\n\n }\n```\n\nIf this option is not included in the setup options, or is explicitly set to\n`nil` then the default install directories will be used. If this value is set\nthe default directories will be ignored.\n\nBear in mind that any parser installed into a parser folder on the runtime path\nwill still be considered installed. (For example if\n\"~/.local/share/nvim/site/parser/c.so\" exists then the \"c\" parser will be\nconsidered installed, even though it is not in `parser_install_dir`)\n\nThe default paths are:\n\n1. first the package folder. Where `nvim-treesitter` is installed.\n2. second the site directory. This is the \"site\" subdirectory of `stdpath(\"data\")`.\n\n## Adding parsers\n\nIf you have a parser that is not on the list of supported languages (either as a repository on Github or in a local directory), you can add it manually for use by `nvim-treesitter` as follows:\n\n1. Clone the repository or [create a new project](https://tree-sitter.github.io/tree-sitter/creating-parsers#project-setup) in, say, `~/projects/tree-sitter-zimbu`. Make sure that the `tree-sitter-cli` executable is installed and in your path; see for installation instructions.\n2. Run `tree-sitter generate` in this directory (followed by `tree-sitter test` for good measure).\n3. Add the following snippet to your `init.lua`:\n\n```lua\nlocal parser_config = require \"nvim-treesitter.parsers\".get_parser_configs()\nparser_config.zimbu = {\n install_info = {\n url = \"~/projects/tree-sitter-zimbu\", -- local path or git repo\n files = {\"src/parser.c\"}, -- note that some parsers also require src/scanner.c or src/scanner.cc\n -- optional entries:\n branch = \"main\", -- default branch in case of git repo if different from master\n generate_requires_npm = false, -- if stand-alone parser without npm dependencies\n requires_generate_from_grammar = false, -- if folder contains pre-generated src/parser.c\n },\n filetype = \"zu\", -- if filetype does not match the parser name\n}\n```\n\nIf you wish to set a specific parser for a filetype, you should use `vim.treesitter.language.register()`:\n\n```lua\nvim.treesitter.language.register('python', 'someft') -- the someft filetype will use the python parser and queries.\n```\n\nNote this requires Nvim v0.9.\n\n4. Start `nvim` and `:TSInstall zimbu`.\n\nYou can also skip step 2 and use `:TSInstallFromGrammar zimbu` to install directly from a `grammar.js` in the top-level directory specified by `url`.\nOnce the parser is installed, you can update it (from the latest revision of the `main` branch if `url` is a Github repository) with `:TSUpdate zimbu`.\n\nNote that neither `:TSInstall` nor `:TSInstallFromGrammar` copy query files from the grammar repository.\nIf you want your installed grammar to be useful, you must manually [add query files](#adding-queries) to your local nvim-treesitter installation.\nNote also that module functionality is only triggered if your language's filetype is correctly identified.\nIf Neovim does not detect your language's filetype by default, you can use [Neovim's `vim.filetype.add()`]() to add a custom detection rule.\n\nIf you use a git repository for your parser and want to use a specific version, you can set the `revision` key\nin the `install_info` table for you parser config.\n\n## Adding queries\n\nQueries are what `nvim-treesitter` uses to extract information from the syntax tree;\nthey are located in the `queries/{language}/*` runtime directories (see `:h rtp`),\nlike the `queries` folder of this plugin, e.g. `queries/{language}/{locals,highlights,textobjects}.scm`.\nOther modules may require additional queries such as `folding.scm`. You can find a\nlist of all supported capture names in [CONTRIBUTING.md](https://github.com/nvim-treesitter/nvim-treesitter/blob/master/CONTRIBUTING.md#parser-configurations).\n\nAll queries found in the runtime directories will be combined.\nBy convention, if you want to write a query, use the `queries/` directory,\nbut if you want to extend a query use the `after/queries/` directory.\n\nIf you want to completely override a query, you can use `:h set_query()`.\nFor example, to override the `injections` queries from `c` with your own:\n\n```lua\nrequire(\"vim.treesitter.query\").set_query(\"c\", \"injections\", \"(comment) @comment\")\n```\n\nNote: when using `set_query`, all queries in the runtime directories will be ignored.\n\n## Adding modules\n\nIf you wish you write your own module, you need to support\n\n- tree-sitter language detection support;\n- attaching and detaching to buffers;\n- all nvim-treesitter commands.\n\nAt the top level, you can use the `define_modules` function to define one or more modules or module groups:\n\n```lua\nrequire'nvim-treesitter'.define_modules {\n my_cool_plugin = {\n attach = function(bufnr, lang)\n -- Do cool stuff here\n end,\n detach = function(bufnr)\n -- Undo cool stuff here\n end,\n is_supported = function(lang)\n -- Check if the language is supported\n end\n }\n}\n```\n\nwith the following properties:\n\n- `module_path` specifies a require path (string) that exports a module with an `attach` and `detach` function. This is not required if the functions are on this definition.\n- `enable` determines if the module is enabled by default. This is usually overridden by the user.\n- `disable` takes a list of languages that this module is disabled for. This is usually overridden by the user.\n- `is_supported` takes a function that takes a language and determines if this module supports that language.\n- `attach` takes a function that attaches to a buffer. This is required if `module_path` is not provided.\n- `detach` takes a function that detaches from a buffer. This is required if `module_path` is not provided.\n\n# Extra features\n\n### Statusline indicator\n\n```vim\necho nvim_treesitter#statusline(90) \" 90 can be any length\nmodule->expression_statement->call->identifier\n```\n\n### Utilities\n\nYou can get some utility functions with\n\n```lua\nlocal ts_utils = require 'nvim-treesitter.ts_utils'\n```\n\nCheck [`:h nvim-treesitter-utils`](doc/nvim-treesitter.txt) for more information.\n\n# Troubleshooting\n\nBefore doing anything, make sure you have the latest version of this plugin and run `:checkhealth nvim-treesitter`.\nIt can also help to update the parsers via `:TSUpdate`.\n\n#### Feature `X` does not work for `{language}`...\n\nFirst, check the `health#nvim_treesitter#check` and the `health#treesitter#check` sections of `:checkhealth` for any warning.\nIf there is one, it's highly likely that this is the cause of the problem.\n\nNext check the `## Parser/Features` subsection of the `health#nvim_treesitter#check` section of `:checkhealth` to ensure the desired module is enabled for your language.\nIf not, you might be missing query files; see [Adding queries](#adding-queries).\n\nFinally, ensure Neovim is correctly identifying your language's filetype using the `:echo &filetype` command while one of your language's files is open in Neovim.\nIf not, add a short Vimscript file to nvim-treesitter's `ftdetect` runtime directory following [Neovim's documentation](https://neovim.io/doc/user/filetype.html#new-filetype) on filetype detection.\nYou can also quickly & temporarily set the filetype for a single buffer with the `:set filetype=langname` command to test whether it fixes the problem.\n\nIf everything is okay, then it might be an actual error.\nIn that case, feel free to [open an issue here](https://github.com/nvim-treesitter/nvim-treesitter/issues/new/choose).\n\n#### I get `module 'vim.treesitter.query' not found`\n\nMake sure you have the latest version of Neovim.\n\n#### I get `Error detected while processing .../plugin/nvim-treesitter.vim` every time I open Neovim\n\nThis is probably due to a change in a parser's grammar or its queries.\nTry updating the parser that you suspect has changed (`:TSUpdate {language}`) or all of them (`:TSUpdate`).\nIf the error persists after updating all parsers,\nplease [open an issue](https://github.com/nvim-treesitter/nvim-treesitter/issues/new/choose).\n\n#### I get `query error: invalid node type at position`\n\nThis could be due a query file outside this plugin using outdated nodes,\nor due to an outdated parser.\n\n- Make sure you have the parsers up to date with `:TSUpdate`\n- Make sure you don't have more than one `parser` runtime directory.\n You can execute this command `:echo nvim_get_runtime_file('parser', v:true)` to find all runtime directories.\n If you get more than one path, remove the ones that are outside this plugin (`nvim-treesitter` directory),\n so the correct version of the parser is used.\n\n#### I experience weird highlighting issues similar to [#78](https://github.com/nvim-treesitter/nvim-treesitter/issues/78)\n\nThis is a well known issue, which arises when the tree and the buffer have gotten out of sync.\nAs this is an upstream issue, we don't have any definite fix.\nTo get around this, you can force reparsing the buffer with\n\n```vim\n:write | edit | TSBufEnable highlight\n```\n\nThis will save, restore and enable highlighting for the current buffer.\n\n#### I experience bugs when using `nvim-treesitter`'s `foldexpr` similar to [#194](https://github.com/nvim-treesitter/nvim-treesitter/issues/194)\n\nThis might happen, and is known to happen, with `vim-clap`.\nTo avoid these kind of errors, please use `setlocal` instead of `set` for the respective filetypes.\n\n#### I run into errors like `module 'nvim-treesitter.configs' not found` at startup\n\nThis is because of `rtp` management in `nvim`, adding `packadd\nnvim-treesitter` should fix the issue.\n\n#### I want to use Git instead of curl for downloading the parsers\n\nIn your Lua config:\n\n```lua\nrequire(\"nvim-treesitter.install\").prefer_git = true\n```\n\n#### I want to use a HTTP proxy for downloading the parsers\n\nYou can either configure curl to use additional CLI arguments in your Lua config:\n\n```lua\nrequire(\"nvim-treesitter.install\").command_extra_args = {\n curl = { \"--proxy\", \"\" },\n}\n```\n\nor you can configure git via `.gitconfig` and use git instead of curl\n\n```lua\nrequire(\"nvim-treesitter.install\").prefer_git = true\n```\n\n#### I want to use a mirror instead of \"https://github.com/\"\n\nIn your Lua config:\n\n```lua\nfor _, config in pairs(require(\"nvim-treesitter.parsers\").get_parser_configs()) do\n config.install_info.url = config.install_info.url:gsub(\"https://github.com/\", \"something else\")\nend\n\nrequire'nvim-treesitter.configs'.setup {\n --\n --\n}\n```\n","configCount":454}}}]