From 214707e327c1bba5c1a3efd3bf4d9cccb592553f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gabriel=20Fr=C3=B3es=20Franco?= <gffranco@gmail.com>
Date: Sun, 31 May 2026 07:54:32 -0300
Subject: [PATCH] docs(client): document link-follow commands on both editors +
 tab-drop

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>
---
 README.md                  | 12 ++++++------
 development/vimwiki-gap.md |  7 +++++--
 doc/nuwiki.txt             | 22 +++++++++++++++++++++-
 3 files changed, 32 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index e10752b..20b5c5e 100644
--- a/README.md
+++ b/README.md
@@ -366,9 +366,8 @@ also call the server directly with `:CocCommand nuwiki.<command>`.
 
 Only the legacy short forms `:VWB` / `:VWS` and `:VimwikiSearch` keep a
 Vimwiki-only name (shown as `—` in the Nuwiki column); every other
-command is mirrored. The split / tab link-following commands exist on
-the Neovim path only — plain Vim uses the `<S-CR>` / `<C-CR>` mappings
-instead.
+command is mirrored. The split / tab link-following commands are
+available on both the Neovim and plain-Vim paths.
 
 **Wiki & navigation**
 
@@ -379,8 +378,9 @@ instead.
 | `:NuwikiUISelect` | `:VimwikiUISelect` | Pick a wiki from a list (multi-wiki) |
 | `:NuwikiGoto {page}` | `:VimwikiGoto {page}` | Open `{page}.wiki` by name |
 | `: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) |
-| `:NuwikiGoBackLink` | `:VimwikiGoBackLink` | Jump back to where you followed the link from (Neovim) |
+| `:NuwikiSplitLink` / `:NuwikiVSplitLink` / `:NuwikiTabnewLink` | `:VimwikiSplitLink` / `:VimwikiVSplitLink` / `:VimwikiTabnewLink` | Follow the link in a horizontal split / vertical split / new tab |
+| `: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 |
 | `:NuwikiNextLink` / `:NuwikiPrevLink` | `:VimwikiNextLink` / `:VimwikiPrevLink` | Jump to the next / previous wikilink |
 | `: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) |
 | `<S-CR>` | Follow in horizontal 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>`) |
 | `<Tab>` / `<S-Tab>` | Next / previous wikilink on or after the cursor |
 | `+` | Wrap word / visual selection as a wikilink (no follow) |
diff --git a/development/vimwiki-gap.md b/development/vimwiki-gap.md
index b01ccdc..b08bc2d 100644
--- a/development/vimwiki-gap.md
+++ b/development/vimwiki-gap.md
@@ -15,11 +15,14 @@ fix site.
 
 ## 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`,
   `VimwikiTabDropLink` exist only in the Neovim branch. Vim users lose
   split-window link following and back-navigation.
-  _Fix:_ `ftplugin/vimwiki.vim` (Vim branch, ~lines 30–175).
+  _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
   symbol change (`gl*` `gl#` `gl-` `gl1` `gla` `gli` … plus `gL…`) has no
   nuwiki keymap; only `:…ChangeSymbol*` commands exist.
diff --git a/doc/nuwiki.txt b/doc/nuwiki.txt
index c8f3079..3f9bfdb 100644
--- a/doc/nuwiki.txt
+++ b/doc/nuwiki.txt
@@ -284,6 +284,25 @@ Wiki / navigation ~
 :NuwikiFollowLink
     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
     Show all references to the current page.
@@ -412,7 +431,8 @@ Links (normal mode) ~
              wraps as `[[word]]` (second <CR> follows the link).
   <S-CR>     Follow in a horizontal 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>`).
   <Tab>      Next wikilink on or after the cursor.
   <S-Tab>    Previous wikilink.