Question 1

How do I enable Tree-sitter parsing in telescope-heading.nvim?

Accepted Answer

Install nvim-treesitter and ensure the language parser is installed, then set `treesitter = true` in the telescope setup under the heading extension. The README provides a configuration example for this, and it falls back to normal parsing if Tree-sitter is unavailable.

Question 2

telescope-heading.nvim vs vim-markdown-navigation: which should I use?

Accepted Answer

telescope-heading supports multiple formats and integrates with Telescope for fuzzy-finding, making it versatile for mixed document workflows. vim-markdown-navigation is lighter but format-specific, so choose based on your need for multi-format support and existing Telescope usage.

Question 3

Does telescope-heading work with LaTeX files?

Accepted Answer

Yes, but without Tree-sitter support, it uses normal parsing which might be less accurate for complex LaTeX documents with custom commands. Check the supported file types table in the README, where LaTeX is marked with an empty square indicating no Tree-sitter.

Question 4

How can I customize the layout of the heading picker in telescope-heading?

Accepted Answer

Set `picker_opts` in the telescope setup under the heading extension, allowing modifications to layout_config and layout_strategy. The README shows an example with width and preview_width adjustments for a horizontal layout.

Question 5

What should I do if telescope-heading isn't detecting headings in my file?

Accepted Answer

Ensure the file type is supported, Tree-sitter is properly installed and configured if enabled, and check for any setup errors. The plugin falls back to normal parsing if Tree-sitter fails, so verify your nvim-treesitter installation as per the README.

Question 6

Can I use telescope-heading without installing nvim-treesitter?

Accepted Answer

Yes, it will fall back to normal parsing, but for formats with Tree-sitter support like Markdown, accuracy might be reduced. The setup allows enabling or disabling Tree-sitter, so you can run it with basic parsing if dependencies are minimized.

telescope-heading.nvim

What is telescope-heading.nvim?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions