diff --git a/book/src/keymap.md b/book/src/keymap.md
index 7a9a43789..b98692144 100644
--- a/book/src/keymap.md
+++ b/book/src/keymap.md
@@ -128,18 +128,18 @@ key to return to normal mode after usage (useful when you're simply looking
 over text and not actively editing it).
 
 
-| Key       | Description                                               | Command             |
-| -----     | -----------                                               | -------             |
-| `z` , `c` | Vertically center the line                                | `align_view_center` |
-| `t`       | Align the line to the top of the screen                   | `align_view_top`    |
-| `b`       | Align the line to the bottom of the screen                | `align_view_bottom` |
-| `m`       | Align the line to the middle of the screen (horizontally) | `align_view_middle` |
-| `j`       | Scroll the view downwards                                 | `scroll_down`       |
-| `k`       | Scroll the view upwards                                   | `scroll_up`         |
-| `f`       | Move page down                                            | `page_down`         |
-| `b`       | Move page up                                              | `page_up`           |
-| `d`       | Move half page down                                       | `half_page_down`    |
-| `u`       | Move half page up                                         | `half_page_up`      |
+| Key           | Description                                               | Command             |
+| -----         | -----------                                               | -------             |
+| `z` , `c`     | Vertically center the line                                | `align_view_center` |
+| `t`           | Align the line to the top of the screen                   | `align_view_top`    |
+| `b`           | Align the line to the bottom of the screen                | `align_view_bottom` |
+| `m`           | Align the line to the middle of the screen (horizontally) | `align_view_middle` |
+| `j` , `down`  | Scroll the view downwards                                 | `scroll_down`       |
+| `k` , `up`    | Scroll the view upwards                                   | `scroll_up`         |
+| `f`           | Move page down                                            | `page_down`         |
+| `b`           | Move page up                                              | `page_up`           |
+| `d`           | Move half page down                                       | `half_page_down`    |
+| `u`           | Move half page up                                         | `half_page_up`      |
 
 #### Goto mode
 
diff --git a/helix-term/src/keymap.rs b/helix-term/src/keymap.rs
index f79978fbb..1a9ea2311 100644
--- a/helix-term/src/keymap.rs
+++ b/helix-term/src/keymap.rs
@@ -651,8 +651,8 @@ impl Default for Keymaps {
                 "t" => align_view_top,
                 "b" => align_view_bottom,
                 "m" => align_view_middle,
-                "k" => scroll_up,
-                "j" => scroll_down,
+                "k" | "up" => scroll_up,
+                "j" | "down" => scroll_down,
                 "C-b" | "pageup" => page_up,
                 "C-f" | "pagedown" => page_down,
                 "C-u" => half_page_up,
@@ -663,8 +663,8 @@ impl Default for Keymaps {
                 "t" => align_view_top,
                 "b" => align_view_bottom,
                 "m" => align_view_middle,
-                "k" => scroll_up,
-                "j" => scroll_down,
+                "k" | "up" => scroll_up,
+                "j" | "down" => scroll_down,
                 "C-b" | "pageup" => page_up,
                 "C-f" | "pagedown" => page_down,
                 "C-u" => half_page_up,