What is the vim command to jump to linked line inside markdown document?

Question

I have created a table of contents at the beginning of my markdown document and linked the headers of the document:

# TOC
[first header](#first-header)

# first header

Now, having opened the document in vim, I want to jump from the reference in the table of contents directly to the respective header. What is the keystroke combination? I found out that with gf I can jump to linked files, but for my case everything is in the same document.

Answer 1

I'm not aware of any built in vim functionality that works like this, but here are 2 options:

• Use the link text to search for the heading. e.g. vi[y/<c-r>0<cr>

  • vi[ visually select inner square brackets
  • y copy the selection
  • / start a search
  • <c-r>0 to access register 0 (the most recent yank)
  • <cr> Enter

• Use the vim-markdown plugin. It allows you to follow named anchors with the ge command. See here -> https://github.com/plasticboy/vim-markdown#follow-named-anchors

Answer 2

One maybe even more elegant solution than manually generating a table of contents is to use the :Toc functionality from the vim-markdown plugin (see https://github.com/plasticboy/vim-markdown#commands). This function opens a new window with a navigatable table of contents.