Merge main into live (#555)

* Update dynamic-profiles.md (#438) * Update dynamic-profiles.md Create section for dynamic profile for `Developer Powershell for VS 2019` * Update dynamic-profiles.md Update name and remove `startingDirectory` * Update dynamic-profiles.md Explain a little better * Update VS version info in 3rd party (#462) * Update custom prompt tutorial w latest OMP steps (#467) * Add themes link * Bulk fix - Removing .localizationpriority (#469) * Testing image (#474) * Update new-tab-same-directory.md * Update new-tab-same-directory.md * Include note on how to save the directory of a pane (#473) * Add decimal value note for pane size Resolves #276 * Remove VS PowerShell and CMD for 3rd party ..these are now officially dynamic profiles.. so no longer need to be added as 3rd party as of Terminal v. 1.12. :) * Add faq for psreadline * Fix formatting * Remove space before code block * Remove code block * Fix link * startingDirectory path for WSL no longer requires prefix * Update custom-prompt-setup.md (#482) * style: fix typo in new-tab-same-directory.md (#486) "it's" should be "its" because it wouldn't make sense otherwise. * Updated based on pull 9270 in Terminal repo * GUID generation for dynamic fragments (#320) (#460) Add information on GUID generation based on microsoft/terminal#10374 and improve wording to make the importance of a profile GUID clearer. * FIx to close #484 * Typo Resolves #483 * Add UTF8 note Resolves #339 * Fix note formatting * Merge release-1.13 into main (#492) Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com> Co-authored-by: Mike Griese <migrie@microsoft.com> * Minor intro rewrite (#487) * typo fix * Remove start from PowerShell commands * winget link fix * Link fix * link fix * link fix * Add `bellsound` profile setting (#508) * Fix typos found by codespell (#501) * Change step to view themes on documentation site (#505) * Set ms.topic: faq where YamlMime:FAQ (#506) * Fix pkgmgr link * troubleshooting: clarify WSL `startingDirectory` entry (#516) * troubleshooting: Linux paths support in 'startingDirectory' was added in 1.11.2921.0 In 7cd48bc (startingDirectory path for WSL no longer requires prefix, 2022-01-07), the "Set your WSL distribution to start in the home directory" section of the troubleshooting guide was updated to mention that WSL paths can now be directly referenced, following microsoft/terminal@a2a6050 (When launching wsl, promote the starting directory to --cd (#9223), 2021-08-02). The text mentions this feature was added in Windows Terminal 1.12.3472.0, but it actually dates back to v1.11.2421.0 (Preview) and v1.11.2921.0 (Stable). Update the text to mention the stable version, and link to this version in the GitHub releases. Also slightly improve the wording (s/are now/can now be/). * troubleshooting: remove confusing 'Important' note about WSL 'startingDirectory' In e7f739e (Docs updates for 1.11 release (#397), 2021-08-31), an "Important" note was added to the "Set your WSL distribution to start in the home directory" section of the troubleshooting page to mention that 'startingDirectory' now accepts Linux-style paths, following microsoft/terminal@a2a6050 (When launching wsl, promote the starting directory to --cd (#9223), 2021-08-02). The note mentions that Linux-styled paths were accepted "on newer versions of Windows", presumably meaning newer than 1903. Indeed, that version was at the time mentioned in the text as the first Windows vesion supporting the '//wsl$/' P9 prefix (it had been mentioned since the WSL startingDirectory troubleshooting entry was created in da815cc (Review troubleshooting page, 2020-05-04). The text of the section was updated in 7cd48bc (startingDirectory path for WSL no longer requires prefix, 2022-01-07) to add an example with a Linux-style path, and to mention that this feature was added in Windows Terminal itself (not in Windows), thus removing the mention of Windows 1903. However, the "Important" note was left, and it still confusingly mentions that Linux-style paths are accepted on "newer" versions of Windows, without mentioning newer than what. Remove the note altogether. * .gitattributes: mark '*.md' as Markdown files Denote Markdown files as such with the 'diff' Git attribute [1]. This allows various Git commands (diff [2, 3], grep [4, 5], log [6], blame [7]) to show in which part of the "code" the changes are located in the hunk header, i.e. the previous commit would be shown as diff --git a/TerminalDocs/troubleshooting.md b/TerminalDocs/troubleshooting.md index 4a880fa..2c9d14d 100644 --- a/TerminalDocs/troubleshooting.md +++ b/TerminalDocs/troubleshooting.md @@ -40,8 +40,6 @@ ## Set your WSL distribution to start in the home `~` directory when launched } ``` -> [!IMPORTANT] -> On newer versions of Windows, `startingDirectory` can accept Linux-style paths. ## Setting the tab title Notice how the hunk header indicates the changes are in the "Set your WSL distribution to start in the home" section. The history of that specific entry can now be interrogated using git log -L:"Set your WSL distribution":TerminalDocs/troubleshooting.md [1] https://git-scm.com/docs/gitattributes#_defining_a_custom_hunk_header [2] https://git-scm.com/docs/git-diff#_generating_patch_text_with_p [3] https://git-scm.com/docs/git-diff#Documentation/git-diff.txt--W [4] https://git-scm.com/docs/git-grep#Documentation/git-grep.txt--p [5] https://git-scm.com/docs/git-grep#Documentation/git-grep.txt--W [6] https://git-scm.com/docs/git-log#Documentation/git-log.txt--Lltfuncnamegtltfilegt [7] https://git-scm.com/docs/git-blame#Documentation/git-blame.txt--Lltfuncnamegt * Remove version specifics relating to WSL paths * New tab same directory (zsh) (#513) * Add acrylic issues to troubleshooting (#518) * Add acrylic issues to troubleshooting doc * Add autohide cursor setting * Add windows settings differentiator * command-palette: simplify example for iterable commands (#511) * Move iterable commands gif lower down * Quoted the env-var for `setx PROMPT` (#502) * Updated --title documentation to specify behavior for panes (#500) * push (#520) * json-fragment-extensions: output GUIDs in "registry format" (#515) * fix(powerline): adjust docs to reflect oh-my-posh changes (#534) * Merge release-1.14 into main (#544) Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com> Co-authored-by: Carlos Zamora <carlos.zamora@microsoft.com> * Fix link * Add package id command for winget (#548) * clarify (#551) * Merge release-1.15 into main (#554) * Document keyboard selection (#552) * minor tweaks * Document scroll marks * Fix warning * Remove old preview labels Co-authored-by: Carlos Zamora <carlos.zamora@microsoft.com> * Add selection to TOC Co-authored-by: Shubham Gogna <36936863+shgogna@users.noreply.github.com> Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com> Co-authored-by: Alma Jenks <v-alje@microsoft.com> Co-authored-by: Jason Howell <5067358+JasonWHowell@users.noreply.github.com> Co-authored-by: Schuyler Rosefield <Rosefield@users.noreply.github.com> Co-authored-by: Sanam <31341013+sanamhub@users.noreply.github.com> Co-authored-by: Haltarys <45515869+Haltarys@users.noreply.github.com> Co-authored-by: Nikolas Grottendieck <git@nikolasgrottendieck.com> Co-authored-by: Mike Griese <migrie@microsoft.com> Co-authored-by: Dimitri Papadopoulos Orfanos <3234522+DimitriPapadopoulos@users.noreply.github.com> Co-authored-by: Shawn Melton <11204251+wsmelton@users.noreply.github.com> Co-authored-by: Alex Buck <abuck@microsoft.com> Co-authored-by: Philippe Blain <levraiphilippeblain@gmail.com> Co-authored-by: Adrien Clairembault <42734840+AdrienClairembault@users.noreply.github.com> Co-authored-by: Paul "TBBle" Hampson <Paul.Hampson@Pobox.com> Co-authored-by: Joshua Cook <me@joshuacook.dev> Co-authored-by: Aaron Junker <aaron.junker@outlook.com> Co-authored-by: Jan De Dobbeleer <2492783+JanDeDobbeleer@users.noreply.github.com> Co-authored-by: Carlos Zamora <carlos.zamora@microsoft.com>
MicrosoftDocs · Jul 6, 2022 · a8539cf · a8539cf
1 parent 86940cf
commit a8539cf
Show file tree

Hide file tree

Showing 6 changed files with 245 additions and 17 deletions.
diff --git a/TerminalDocs/TOC.yml b/TerminalDocs/TOC.yml
@@ -30,6 +30,8 @@
       href: command-palette.md
     - name: Search
       href: search.md
+    - name: Selection
+      href: selection.md
     - name: Panes
       href: panes.md
     - name: Dynamic profiles

diff --git a/TerminalDocs/customize-settings/actions.md b/TerminalDocs/customize-settings/actions.md
@@ -3,7 +3,7 @@ title: Windows Terminal Actions
 description: Learn how to create custom actions for Windows Terminal.
 author: cinnamon-msft
 ms.author: cinnamon
-ms.date: 05/24/2022
+ms.date: 07/06/2022
 ms.topic: how-to
 ---
 
@@ -823,7 +823,8 @@ This copies the selected terminal content to your clipboard. If no selection exi
 
 // In defaults.json
 { "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+shift+c" },
-{ "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+insert" }
+{ "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+insert" },
+{ "command": { "action": "copy", "singleLine": false }, "keys": "enter" }
 ```
 
 #### Parameters
@@ -850,7 +851,7 @@ This inserts the content that was copied onto the clipboard.
 { "command": "paste", "keys": "shift+insert" }
 ```
 
-### Select all ([Preview](https://aka.ms/terminal-preview))
+### Select all
 
 This selects all of the content in the text buffer.
 
@@ -862,6 +863,48 @@ This selects all of the content in the text buffer.
 { "command": "selectAll", "keys": "ctrl+shift+a" }
 ```
 
+### Mark mode ([Preview](https://aka.ms/terminal-preview))
+
+This toggles mark mode. Mark mode is a mode where you can use the keyboard to create a selection at the cursor's position in the terminal.
+
+**Command name:** `markMode`
+
+**Default bindings:**
+
+```json
+{ "command": "markMode", "keys": "ctrl+shift+m" },
+```
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+### Switch selection marker ([Preview](https://aka.ms/terminal-preview))
+
+When modifying a selection using the keyboard, you are moving one end of the selection around. You can use this action to switch to the other selection marker.
+
+**Command name:** `switchSelectionEndpoint`
+
+**Default bindings:**
+
+```json
+{ "command": "switchSelectionEndpoint" },
+```
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+### Toggle block selection ([Preview](https://aka.ms/terminal-preview))
+
+Makes the exisiting selection a block selection, meaning that the selected area is a rectangle, as opposed to wrapping to the beginning and end of each line.
+
+**Command name:** `toggleBlockSelection`
+
+**Default bindings:**
+
+```json
+{ "command": "toggleBlockSelection" },
+```
+
 > [!IMPORTANT]
 > This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
 
@@ -1068,6 +1111,78 @@ Changes the active color scheme.
 { "command": { "action": "setColorScheme", "colorScheme": "Campbell" }, "keys": "" }
 ```
 
+### Experimental add scroll mark ([Preview](https://aka.ms/terminal-preview))
+
+Adds a scroll mark to the text buffer. If there's a selection, the mark is placed at the selection, otherwise it's placed at the cursor row. This is an experimental feature, and its continued existence is not guaranteed.
+
+**Command name:** `addMark`
+
+#### Parameters
+
+| Name | Necessity | Accepts | Description |
+| ---- | --------- | ------- | ----------- |
+| `color` | Optional | String, in hex format: `"#rgb"` or `"#rrggbb"` | The color of the mark. |
+
+**Example binding:**
+
+```json
+{ "command": { "action": "addMark", "color": "#ff00ff" } }
+```
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+### Experimental scroll to mark ([Preview](https://aka.ms/terminal-preview))
+
+Scrolls to the scroll mark in the given direction. This is an experimental feature, and its continued existence is not guaranteed.
+
+**Command name:** `scrollToMark`
+
+#### Parameters
+
+| Name | Necessity | Accepts | Description |
+| ---- | --------- | ------- | ----------- |
+| `direction` | Required | `"first"`, `"previous"`, `"next"`, `"last"` | The direction in which to scroll. |
+
+**Example binding:**
+
+```json
+{ "command": { "action": "scrollToMark", "direction": "previous" } }
+```
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+### Experimental clear mark ([Preview](https://aka.ms/terminal-preview))
+
+Clears scroll mark at the current position, either at a selection if there is one or at the cursor position. This is an experimental feature, and its continued existence is not guaranteed.
+
+**Command name:** `clearMark`
+
+**Example binding:**
+
+```json
+{ "command": { "action": "clearMark" } }
+```
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+### Experimental clear all marks ([Preview](https://aka.ms/terminal-preview))
+
+Clears all scroll marks in the text buffer. This is an experimental feature, and its continued existence is not guaranteed.
+
+**Command name:** `clearAllMarks`
+
+**Example binding:**
+
+```json
+{ "command": { "action": "clearAllMarks" } }
+```
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
 <br />
 
 ___

diff --git a/TerminalDocs/customize-settings/appearance.md b/TerminalDocs/customize-settings/appearance.md
@@ -3,7 +3,7 @@ title: Windows Terminal Appearance Settings
 description: Learn how to customize appearance settings within Windows Terminal.
 author: cinnamon-msft
 ms.author: cinnamon
-ms.date: 05/24/2022
+ms.date: 07/06/2022
 ms.topic: how-to
 ---
 
@@ -223,7 +223,7 @@ When this is set to `true`, closing a window with multiple tabs open _will_ requ
 
 ___
 
-## Use a background image for the entire window ([Preview](https://aka.ms/terminal-preview))
+## Use a background image for the entire window
 
 When set to `true`, the background image for the currently focused profile is expanded to encompass the entire window, beneath other panes. This is an experimental feature, and its continued existence is not guaranteed.
 
@@ -234,6 +234,3 @@ When set to `true`, the background image for the currently focused profile is ex
 **Accepts:** `true`, `false`
 
 **Default value:** `false`
-
-> [!IMPORTANT]
-> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
diff --git a/TerminalDocs/customize-settings/profile-advanced.md b/TerminalDocs/customize-settings/profile-advanced.md
@@ -3,7 +3,7 @@ title: Windows Terminal Advanced Profile Settings
 description: Learn how to customize the advanced profile settings within Windows Terminal.
 author: cinnamon-msft
 ms.author: cinnamon
-ms.date: 05/24/2022
+ms.date: 07/06/2022
 ms.topic: how-to
 ---
 
@@ -149,6 +149,38 @@ When `bellStyle` is set to `"all"` or `"audible"`, this allows you to choose the
 
 ___
 
+## Scroll marks ([Preview](https://aka.ms/terminal-preview))
+
+The following settings modify how scroll marks behave in Windows Terminal.
+
+### Experimental automatically add scroll marks ([Preview](https://aka.ms/terminal-preview))
+
+Automatically marks prompts when set to `true`. This is an experimental feature, and its continued existence is not guaranteed.
+
+**Property name:** `experimental.autoMarkPrompts`
+
+**Necessity:** Optional
+
+**Accepts:** `true`, `false`
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+### Experimental show marks on scrollbar ([Preview](https://aka.ms/terminal-preview))
+
+Displays marks on the scrollbar when set to `true`. This is an experimental feature, and its continued existence is not guaranteed.
+
+**Property name:** `experimental.showMarksOnScrollbar`
+
+**Necessity:** Optional
+
+**Accepts:** `true`, `false`
+
+> [!IMPORTANT]
+> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
+
+___
+
 ## Experimental text rendering engine
 
 Enables use of the experimental text rendering engine for the profile. This is an experimental feature and its continued existence is not guaranteed. A new instance of the profile needs to be opened in order for this setting to take effect.
@@ -165,7 +197,7 @@ Enables use of the experimental text rendering engine for the profile. This is a
 
 ___
 
-## VT passthrough mode ([Preview](https://aka.ms/terminal-preview))
+## VT passthrough mode
 
 When set to true, directs the PTY for this connection to use pass-through mode instead of the original Conhost PTY simulation engine. This is an experimental feature, and its continued existence is not guaranteed.
 
@@ -177,9 +209,6 @@ When set to true, directs the PTY for this connection to use pass-through mode i
 
 **Default value:** `false`
 
-> [!IMPORTANT]
-> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
-
 <br />
 
 ___

diff --git a/TerminalDocs/install.md b/TerminalDocs/install.md
@@ -19,7 +19,10 @@ To try the latest preview features, you may also want to [install Windows Termin
 > [!NOTE]
 > If you don't have access to the Microsoft Store, the builds are published on the **[GitHub releases page](https://github.com/microsoft/terminal/releases)**. If you install from GitHub, Windows Terminal will not automatically update with new versions. For additional installation options using a package manager (winget, chocolatey, scoop), see the **[Windows Terminal product repo](https://github.com/microsoft/terminal#other-install-methods)**.
 
-## Set your default terminal application ([Preview](https://aka.ms/terminal-preview))
+## Set your default terminal application
+
+> [!IMPORTANT]
+> This feature is only available in [Windows 11](https://www.microsoft.com/windows/).
 
 To open any command line application with Windows Terminal, set it as your default terminal application.
 
@@ -28,9 +31,6 @@ To open any command line application with Windows Terminal, set it as your defau
 
 ![Screenshot of Windows Terminal Startup default in Settings UI](./images/settings-default-shell.png)
 
-> [!IMPORTANT]
-> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).
-
 ## Set your default terminal profile
 
 After installation, when you open Windows Terminal, it will start with the [PowerShell](/powershell) command line as the default profile in the open tab.

diff --git a/TerminalDocs/selection.md b/TerminalDocs/selection.md
@@ -0,0 +1,85 @@
+---
+title: Selection
+description: Learn how to select text in Windows Terminal.
+author: cinnamon-msft
+ms.author: cinnamon
+ms.date: 07/06/2022
+ms.topic: how-to
+---
+
+# Selecting text in Windows Terminal
+
+Selecting text is straightforward in Windows Terminal, but there are a lot of additional features in this space that make it even better.
+
+## Mouse support
+
+Left-click and drag your mouse to create a selection. Double-click expands the selection by word, whereas triple-click expands by line.
+
+If you are holding the <kbd>Alt</kbd> key, you will create a block selection (as opposed to a line selection). Block selections create a rectangular region that do not wrap to the end of the line.
+
+If you are holding the <kbd>Shift</kbd> key, you can explicitly expand the selection to a specific point on the terminal without the need to click and drag.
+
+Once you have a selection present, you have a few options. A single left-click will clear your selection. If you actually want to use it, you can right-click to copy the selected text to your clipboard and clear the selection. If you right-click again, the contents of your clipboard will then be pasted into the terminal.
+
+> [!NOTE]
+> Windows Terminal supports mouse input in Windows Subsystem for Linux (WSL) applications as well as Windows applications that use virtual terminal (VT) input. This means applications such as [tmux](https://github.com/tmux/tmux/wiki) and [Midnight Commander](https://www.linuxhelp.com/how-to-install-midnight-commander-in-linux) will recognize when you select items in the terminal window. If an application is in mouse mode, you can hold down <kbd>Shift</kbd> to make a selection instead of sending VT input.
+
+## Keyboard support
+
+You can create a selection by using the `selectAll` or `markMode` actions. The `selectAll` action selects all the text in the buffer. The `markMode` action toggles a special mode where a selection is created at the cursor's position in the terminal. When in mark mode, you can use the following non-configurable key bindings to move the cursor around:
+
+| Key binding | Result |
+| ----------- | ------ |
+| Arrow keys | Move by character in the specified direction |
+| <kbd>Ctrl</kbd> + <kbd>Left</kbd> | Move to the beginning of the previous or existing word |
+| <kbd>Ctrl</kbd> + <kbd>Right</kbd> | Move to the end of the next or existing word |
+| <kbd>Home</kbd> | Move to the beginning of the line |
+| <kbd>End</kbd> | Move to the end of the line |
+| <kbd>Pgup</kbd> | Move up by a page (viewport) |
+| <kbd>Pgdn</kbd> | Move down by a page (viewport) |
+| <kbd>Ctrl</kbd> + <kbd>Home</kbd> | Move to the beginning of the buffer |
+| <kbd>Ctrl</kbd> + <kbd>End</kbd> | Move to the end of the buffer |
+
+Regardless of being in mark mode, you can expand an existing selection using the following non-configurable key bindings:
+
+| Key binding | Result |
+| ----------- | ------ |
+| <kbd>Shift</kbd> + Arrow keys | Expand by character in the specified direction |
+| <kbd>Ctrl</kbd> + <kbd>Left</kbd> | Expand to the beginning of the previous or existing word |
+| <kbd>Ctrl</kbd> + <kbd>Right</kbd> | Expand to the end of the next or existing word |
+| <kbd>Shift</kbd> + <kbd>Home</kbd> | Expand to the beginning of the line |
+| <kbd>Shift</kbd> + <kbd>End</kbd> | Expand to the end of the line |
+| <kbd>Shift</kbd> + <kbd>Pgup</kbd> | Expand up by a page (viewport) |
+| <kbd>Shift</kbd> + <kbd>Pgdn</kbd> | Expand down by a page (viewport) |
+| <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd> | Expand to the beginning of the buffer |
+| <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd> | Expand to the end of the buffer |
+
+Use the `toggleBlockSelection` action to transform the existing selection into a block selection.
+
+Any selection created or modified by the keyboard also displays selection markers to indicate which end of the selection is actively being moved. You can use the `switchSelectionEndpoint` action to begin moving the other end of the selection.
+
+Once you have a selection present, you have a few options. You can use the <kbd>ESC</kbd> key to clear the selection. Alternatively, most key input clears the selection and passes the key event directly to the underlying shell. If you actually want to use the selected text, you can use the `copy` action to copy it to your clipboard.
+
+## Copying selected text
+
+As mentioned above, selected text can be copied with a right-click or the `copy` action. However, there are a number of settings regarding copying text that you can customize:
+- Copying formatted text
+    - You can use the `copyFormatting` global setting to also copy the formatting of the selected text itself to the clipboard. This allows you to copy the terminal's font information such as foreground color, background color, and font.
+    - If you want to limit copying the formatting to certain key bindings (or commands), you can modify the `copyFormatting` parameter on a `copy` action.
+- Copying as a single line
+    - You can copy text as a single line using the `singleLine` parameter in the `copy` action.
+- Removing trailing whitespace from block selections
+    - You can remove the trailing whitespace from a block selection using the `trimBlockSelection` global setting.
+
+You can also use the `copyOnSelect` global setting to have newly selected text automatically copied to your clipboard. With this setting enabled, if a selection is present, right-clicking the terminal copies and pastes the selected text to your terminal.
+
+> [!NOTE]
+> If `copyOnSelect` is enabled, modifying the selection using the keyboard does not automatically copy the newly selected text. You will need to manually copy the text using the `copy` action or by right-clicking the terminal.
+
+## Customizing the appearance of selections
+
+Color schemes let you customize the selection color using the `selectionBackground` property in a color scheme. Alternatively, you can override the selection color for a specific profile using the `selectionBackground` profile setting.
+
+## Customizing word delimiters
+
+As mentioned above, double-clicking and using <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + Arrow keys (or <kbd>Ctrl</kbd> + Arrow keys when in mark mode) allow you to navigate by word. However, words can be separated by more than just whitespace. You can customize these word boundaries using the `wordDelimiters` global setting.