[FR] View headings of a file, either from the same file or different files.

[aniketgm]

Please confirm

• [x] I am running the latest version of this plugin

Is your feature request related to a problem? Please describe.

Not related to a problem, but from the following discussion here

Describe the solution you'd like

It would be really nice to have a feature to view and jump to a heading either in the current file Or a different file (other than the current buffer) For the different file headings scenario, the following suggestion was discussed:

• The use-case is basically something like -- after opening find_notes to look for a file, instead of pressing enter on the file that is under selection/under the cursor, one can press some other key that opens the headings of that file that will directly take us to that heading in that file. This scenario is mentioned in more detail in @lambtho12 reply to my question. https://github.com/renerocksai/telekasten.nvim/discussions/210#discussioncomment-4833943

Another suggestion is to show headings of all notes in one view and then select and jump to it.

Describe alternatives you've considered

• Alternative is just that you open the file using find_notes and once opened, then go to the heading manually using -- ctrl+d / ctrl+u / h / j / k / l. For long notes this will be hectic and tiring.
• For the same file heading there is "telescope-headings" plugin, which is a nice one, however, it seems that it adds a bit of extra unnecessary code of other plugins that it supports like org, neorg, beancount, etc., which many may not be using.

Additional context Add any other context or screenshots about the feature request here.

[lambtho12]

Note for future me:

1. Get inspiration from telescope-headings for the heading picker
2. Make a function find_headings(file) that shows the headings of any file
3. Make an easy to use function that will default to the current buffer so people can use that mapping (suggest <leader>zh)
4. Add a Telescope actions (C-h) to the relevant pickers that will call find_headings(selected)
5. Add picker actions to find_headings(file) so we can yank and insert directly the link to the proper heading

[Rom1deTroyes]

I use tagbar-markdown to get an overview of my Telekasten files (and navigate big md files):

"" Display tags ordered by scope in a window
Plug 'preservim/tagbar'
Plug 'lvht/tagbar-markdown'

You can see all the structure of the file, fold the levels and navigate easily in the tagbar or in the file, open a preview, and even choose to sort in alphabetical order :-)

[lambtho12]

Seems like a neat plugin! Thanks for pointing it out!

[aniketgm]

Tagbar is a nice plugin and I've used it before, for a python development project. However, I faced some issues, one of them being like:

• If I navigate to a start of a function (line from where function begins) using tagbar and move down in the file (even if it's in the same function), then after few seconds, my cursor would automatically jump to the function start line (line from where function starts).

and not just this I was getting some other issues as well. It was getting pretty hectic, since then I stopped using it. @Rom1deTroyes have you faced such issue ? Not sure if they solved it or not. Maybe I'll check it out again. Thanks.