docs(client): document link-follow commands on both editors + tab-drop
CI / cargo fmt --check (push) Successful in 19s
CI / cargo clippy (push) Failing after 18s
CI / cargo test (push) Successful in 40s
CI / editor keymaps (push) Successful in 1m26s

The split/tab link-follow commands are no longer Neovim-only; document
:Nuwiki/Vimwiki{Split,VSplit,Tabnew,TabDrop,GoBack}Link and note that
<C-S-CR> follows a link in a tab reusing an existing one. Tick parity
gap P1 #1 in the tracking doc.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-31 07:54:32 -03:00
parent 82b6bc9c60
commit 214707e327
3 changed files with 32 additions and 9 deletions
+6 -6
View File
@@ -366,9 +366,8 @@ also call the server directly with `:CocCommand nuwiki.<command>`.
Only the legacy short forms `:VWB` / `:VWS` and `:VimwikiSearch` keep a Only the legacy short forms `:VWB` / `:VWS` and `:VimwikiSearch` keep a
Vimwiki-only name (shown as `—` in the Nuwiki column); every other Vimwiki-only name (shown as `—` in the Nuwiki column); every other
command is mirrored. The split / tab link-following commands exist on command is mirrored. The split / tab link-following commands are
the Neovim path only — plain Vim uses the `<S-CR>` / `<C-CR>` mappings available on both the Neovim and plain-Vim paths.
instead.
**Wiki & navigation** **Wiki & navigation**
@@ -379,8 +378,9 @@ instead.
| `:NuwikiUISelect` | `:VimwikiUISelect` | Pick a wiki from a list (multi-wiki) | | `:NuwikiUISelect` | `:VimwikiUISelect` | Pick a wiki from a list (multi-wiki) |
| `:NuwikiGoto {page}` | `:VimwikiGoto {page}` | Open `{page}.wiki` by name | | `:NuwikiGoto {page}` | `:VimwikiGoto {page}` | Open `{page}.wiki` by name |
| `:NuwikiFollowLink` | `:VimwikiFollowLink` | Follow the link under the cursor | | `:NuwikiFollowLink` | `:VimwikiFollowLink` | Follow the link under the cursor |
| `:NuwikiSplitLink` / `:NuwikiVSplitLink` / `:NuwikiTabnewLink` | `:VimwikiSplitLink` / `:VimwikiVSplitLink` / `:VimwikiTabnewLink` | Follow the link in a horizontal split / vertical split / new tab (Neovim) | | `:NuwikiSplitLink` / `:NuwikiVSplitLink` / `:NuwikiTabnewLink` | `:VimwikiSplitLink` / `:VimwikiVSplitLink` / `:VimwikiTabnewLink` | Follow the link in a horizontal split / vertical split / new tab |
| `:NuwikiGoBackLink` | `:VimwikiGoBackLink` | Jump back to where you followed the link from (Neovim) | | `:NuwikiTabDropLink` | `:VimwikiTabDropLink` | Follow the link in a tab, reusing an existing tab if the file is already open |
| `:NuwikiGoBackLink` | `:VimwikiGoBackLink` | Jump back to where you followed the link from |
| `:NuwikiBacklinks` | `:VimwikiBacklinks` (`:VWB`) | Show all references to the current page | | `:NuwikiBacklinks` | `:VimwikiBacklinks` (`:VWB`) | Show all references to the current page |
| `:NuwikiNextLink` / `:NuwikiPrevLink` | `:VimwikiNextLink` / `:VimwikiPrevLink` | Jump to the next / previous wikilink | | `:NuwikiNextLink` / `:NuwikiPrevLink` | `:VimwikiNextLink` / `:VimwikiPrevLink` | Jump to the next / previous wikilink |
| `:NuwikiBaddLink` | `:VimwikiBaddLink` | Add the link target under the cursor to the buffer list | | `:NuwikiBaddLink` | `:VimwikiBaddLink` | Add the link target under the cursor to the buffer list |
@@ -465,7 +465,7 @@ via `mappings.<group> = false` in Neovim, or
| `<CR>` | Smart follow — inside `[[…]]` jumps; on a bare word wraps as `[[word]]` (second `<CR>` follows) | | `<CR>` | Smart follow — inside `[[…]]` jumps; on a bare word wraps as `[[word]]` (second `<CR>` follows) |
| `<S-CR>` | Follow in horizontal split | | `<S-CR>` | Follow in horizontal split |
| `<C-CR>` | Follow in vertical split | | `<C-CR>` | Follow in vertical split |
| `<C-S-CR>` | Follow in a new tab | | `<C-S-CR>` | Follow in a tab, reusing an existing tab if the file is already open |
| `<BS>` | Jump back (`<C-o>`) | | `<BS>` | Jump back (`<C-o>`) |
| `<Tab>` / `<S-Tab>` | Next / previous wikilink on or after the cursor | | `<Tab>` / `<S-Tab>` | Next / previous wikilink on or after the cursor |
| `+` | Wrap word / visual selection as a wikilink (no follow) | | `+` | Wrap word / visual selection as a wikilink (no follow) |
+5 -2
View File
@@ -15,11 +15,14 @@ fix site.
## P1 — Core workflow gaps (fix first) ## P1 — Core workflow gaps (fix first)
- [ ] **Vim client split/tab link-follow commands**`VimwikiSplitLink`, - [x] **Vim client split/tab link-follow commands**`VimwikiSplitLink`,
`VimwikiVSplitLink`, `VimwikiGoBackLink`, `VimwikiTabnewLink`, `VimwikiVSplitLink`, `VimwikiGoBackLink`, `VimwikiTabnewLink`,
`VimwikiTabDropLink` exist only in the Neovim branch. Vim users lose `VimwikiTabDropLink` exist only in the Neovim branch. Vim users lose
split-window link following and back-navigation. split-window link following and back-navigation.
_Fix:_ `ftplugin/vimwiki.vim` (Vim branch, ~lines 30175). _Fix:_ `ftplugin/vimwiki.vim` (Vim branch) — commands added + `:Nuwiki*`
aliases; `follow_link_drop()` helper in `autoload/nuwiki/commands.vim`;
true `:tab drop` tab-reuse wired in both clients (`lua/nuwiki/commands.lua`
`open_uri` `'tabdrop'` case); `<C-S-CR>` repointed to tab-drop.
- [ ] **`gl<symbol>` change-symbol mappings** — upstream's one-key bullet/number - [ ] **`gl<symbol>` change-symbol mappings** — upstream's one-key bullet/number
symbol change (`gl*` `gl#` `gl-` `gl1` `gla` `gli` … plus `gL…`) has no symbol change (`gl*` `gl#` `gl-` `gl1` `gla` `gli` … plus `gL…`) has no
nuwiki keymap; only `:…ChangeSymbol*` commands exist. nuwiki keymap; only `:…ChangeSymbol*` commands exist.
+21 -1
View File
@@ -284,6 +284,25 @@ Wiki / navigation ~
:NuwikiFollowLink :NuwikiFollowLink
Follow the link under the cursor. Follow the link under the cursor.
*:NuwikiSplitLink*
:NuwikiSplitLink
*:NuwikiVSplitLink*
:NuwikiVSplitLink
*:NuwikiTabnewLink*
:NuwikiTabnewLink
Follow the link under the cursor in a horizontal split, vertical
split, or new tab respectively.
*:NuwikiTabDropLink*
:NuwikiTabDropLink
Follow the link under the cursor in a tab, reusing an existing tab
if the target file is already open (otherwise a new tab is created).
*:NuwikiGoBackLink*
:NuwikiGoBackLink
Jump back to where you followed the link from (via the jumplist,
|CTRL-O|).
*:NuwikiBacklinks* *:NuwikiBacklinks*
:NuwikiBacklinks :NuwikiBacklinks
Show all references to the current page. Show all references to the current page.
@@ -412,7 +431,8 @@ Links (normal mode) ~
wraps as `[[word]]` (second <CR> follows the link). wraps as `[[word]]` (second <CR> follows the link).
<S-CR> Follow in a horizontal split. <S-CR> Follow in a horizontal split.
<C-CR> Follow in a vertical split. <C-CR> Follow in a vertical split.
<C-S-CR> Follow in a new tab. <C-S-CR> Follow in a tab, reusing an existing tab if the file is
already open.
<BS> Jump back (`<C-o>`). <BS> Jump back (`<C-o>`).
<Tab> Next wikilink on or after the cursor. <Tab> Next wikilink on or after the cursor.
<S-Tab> Previous wikilink. <S-Tab> Previous wikilink.