Question 1

How to install TrailBlazer.nvim with lazy.nvim?

Accepted Answer

Add 'LeonHeidelbach/trailblazer.nvim' to your lazy.nvim spec and call require('trailblazer').setup() with your configuration options. The README provides a packer example, but lazy.nvim follows a similar pattern with its setup function.

Question 2

TrailBlazer.nvim vs Harpoon: which is better for marking files?

Accepted Answer

TrailBlazer excels at marking specific locations within files with stack-based navigation and multiple modes, while Harpoon focuses on bookmarking entire files for quick switching. Choose TrailBlazer for granular location marks and Harpoon for file-level jumps.

Question 3

Can TrailBlazer automatically save marks when I close Neovim?

Accepted Answer

Yes, enable the auto_save_trailblazer_state_on_exit option in the configuration to save sessions on exit. However, this only works if a session has been previously loaded or saved, as noted in the Trail Mark Sessions section.

Question 4

How to customize keybindings for creating a new trail mark?

Accepted Answer

Modify the 'mappings' key in the config table; for example, set new_trail_mark under motions to your preferred key. The README provides a default mapping example and instructions for overriding them.

Question 5

Does TrailBlazer work with other Neovim plugins like leap.nvim?

Accepted Answer

TrailBlazer is complementary to plugins like leap.nvim—use leap for quick, within-buffer jumps and TrailBlazer for persistent mark-based navigation across files. No direct integration is mentioned, but they can coexist in a workflow.

Question 6

How to delete all trail marks in a specific buffer?

Accepted Answer

Use the :TrailBlazerDeleteAllTrailMarks command with the buffer argument, or configure a keybinding. The User Commands section details how to specify buffers for targeted operations.

Question 7

What are the performance implications of using TrailBlazer on large projects?

Accepted Answer

While not explicitly tested, maintaining multiple mark stacks and real-time updates could add overhead in very large codebases. The plugin uses Neovim's sign API, which may impact rendering with many marks, but no benchmarks are provided.

trailblazer.nvim

What is trailblazer.nvim?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions