docs: align keymap docs with demo wording

Author: Only-Moon

README.md

@@ -35,20 +35,20 @@ On first install/update, the plugin also shows a one-time welcome notification.
 
 ## GUI -> Vim Keymap Comparison
 
-| GUI Shortcut | Action | Vim Equivalent |
-|--------------|--------|----------------|
-| Ctrl+C | Copy | `y` / `yy` |
-| Ctrl+V | Paste | `p` |
-| Ctrl+X | Cut | `d` |
-| Ctrl+A | Select All | `ggVG` |
-| Ctrl+Z | Undo | `u` |
-| Ctrl+Y | Redo | `<C-r>` |
-| Ctrl+S | Save | `:write` |
-| Ctrl+Q | Save and close | `:confirm wq` |
-| Home | Move to line start | `0` |
-| End | Move to line end | `$` |
-| Ctrl+Backspace | Delete previous word | GUI-style previous-word delete |
-| Ctrl+Delete | Delete next word | GUI-style next-word delete |
+| GUI Shortcut | Vim Equivalent | Action |
+|--------------|----------------|--------|
+| Ctrl+C | `y` / `yy` | Copy |
+| Ctrl+V | `p` | Paste |
+| Ctrl+X | `d` | Cut |
+| Ctrl+A | `ggVG` | Select All |
+| Ctrl+Z | `u` | Undo |
+| Ctrl+Y | `<C-r>` | Redo |
+| Ctrl+S | `:write` | Save |
+| Ctrl+Q | `:confirm wq` | Save and close |
+| Home | `0` | Move to line start |
+| End | `$` | Move to line end |
+| Ctrl+Backspace | GUI-style previous-word delete | Delete previous word |
+| Ctrl+Delete | GUI-style next-word delete | Delete next word |
 
 ## Installation
 

docs/index.md

@@ -32,6 +32,12 @@ It provides:
 3. Test the shortcuts in the scratch buffer.
 4. Open `:GuiKeymapInfo` if something does not behave as expected.
 
+The demo and keymap reference use the same teaching order:
+
+- GUI shortcut
+- Vim equivalent
+- resulting action
+
 ## Project links
 
 - Repository: [Only-Moon/gui-keymap.nvim](https://github.com/Only-Moon/gui-keymap.nvim)

docs/keymaps.md

@@ -2,34 +2,38 @@
 
 ## GUI shortcut table
 
-| Shortcut | Mode | Behavior | Vim equivalent |
-|----------|------|----------|----------------|
-| `Ctrl+C` | normal | copy line | `yy` |
-| `Ctrl+C` | visual | copy selection | `y` |
-| `Ctrl+V` | normal | paste | `p` |
-| `Ctrl+V` | insert | paste | insert paste |
-| `Ctrl+X` | visual | cut selection | `d` |
-| `Ctrl+A` | normal | select all | `ggVG` |
-| `Ctrl+A` | insert | select all | `<Esc>ggVG` |
-| `Ctrl+Z` | normal | undo | `u` |
-| `Ctrl+Z` | insert | undo | `<C-o>u` |
-| `Ctrl+Y` | normal | redo | `<C-r>` |
-| `Ctrl+Y` | insert | redo | `<C-o><C-r>` |
-| `Ctrl+S` | normal | save buffer | `:write` |
-| `Ctrl+S` | insert | save buffer | `:write` |
-| `Ctrl+S` | visual | save buffer | `:write` |
-| `Ctrl+Q` | normal | save and close | `:confirm wq` |
-| `Ctrl+Q` | insert | save and close | `:confirm wq` |
-| `Home` | normal | line start | `0` |
-| `Home` | insert | line start | `<C-o>0` |
-| `Home` | visual | line start | `0` |
-| `End` | normal | line end | `$` |
-| `End` | insert | line end | `<C-o>$` |
-| `End` | visual | line end | `$` |
-| `Ctrl+Backspace` | normal | delete previous word | GUI-style previous-word delete |
-| `Ctrl+Backspace` | insert | delete previous word | GUI-style previous-word delete |
-| `Ctrl+Delete` | normal | delete next word | GUI-style next-word delete |
-| `Ctrl+Delete` | insert | delete next word | GUI-style next-word delete |
+This page follows the same teaching order as `:GuiKeymapDemo`:
+
+`GUI shortcut -> Vim equivalent -> action`
+
+| Shortcut | Mode | Vim equivalent | Action |
+|----------|------|----------------|--------|
+| `Ctrl+C` | normal | `yy` | Copy line |
+| `Ctrl+C` | visual | `y` | Copy selection |
+| `Ctrl+V` | normal | `p` | Paste |
+| `Ctrl+V` | insert | insert paste | Paste |
+| `Ctrl+X` | visual | `d` | Cut selection |
+| `Ctrl+A` | normal | `ggVG` | Select all |
+| `Ctrl+A` | insert | `<Esc>ggVG` | Select all |
+| `Ctrl+Z` | normal | `u` | Undo |
+| `Ctrl+Z` | insert | `<C-o>u` | Undo |
+| `Ctrl+Y` | normal | `<C-r>` | Redo |
+| `Ctrl+Y` | insert | `<C-o><C-r>` | Redo |
+| `Ctrl+S` | normal | `:write` | Save buffer |
+| `Ctrl+S` | insert | `:write` | Save buffer |
+| `Ctrl+S` | visual | `:write` | Save buffer |
+| `Ctrl+Q` | normal | `:confirm wq` | Save and close |
+| `Ctrl+Q` | insert | `:confirm wq` | Save and close |
+| `Home` | normal | `0` | Move to line start |
+| `Home` | insert | `<C-o>0` | Move to line start |
+| `Home` | visual | `0` | Move to line start |
+| `End` | normal | `$` | Move to line end |
+| `End` | insert | `<C-o>$` | Move to line end |
+| `End` | visual | `$` | Move to line end |
+| `Ctrl+Backspace` | normal | GUI-style previous-word delete | Delete previous word |
+| `Ctrl+Backspace` | insert | GUI-style previous-word delete | Delete previous word |
+| `Ctrl+Delete` | normal | GUI-style next-word delete | Delete next word |
+| `Ctrl+Delete` | insert | GUI-style next-word delete | Delete next word |
 
 ## Delete-selection mappings