跳到主要内容

Vim mode — 设置

打开 Obsidian 的 设置 → 选择社区插件 Universal Cursor Hotkeys → 打开上方标签 Vim mode。

本页面中的设置开关里,Motion upgrades(共 8 个)以及 Table commands 中的 2 个(Table structure 和 Table navigation),从 OFF → ON 会立即生效;但从 ON → OFF 时,需要重启应用才能完全生效。(需要重启时会显示 Restart 按钮)

Motion upgrades(行为升级)​

每个按键分组都有各自的开关,可以选择保持 Obsidian 标准 Vim mode 的原有行为(OFF),还是改用本插件的升级行为(ON)。

关于标准行为与升级行为的差异,请参阅 命令参考。

开关默认值说明
h l x 字符移动/删除ON—
j k 行移动ON—
w b e 单词移动ON—
gg G 笔记开头/末尾ON—
gj gk 显示行移动ON—
$ 吸附到行末ON需要 j/k 行移动或 gj/gk 显示行移动为 ON。
^ I 首个非空白字符ON若要使用 Smart home 行为,需要先在 Behavior options 中将 Smart home (standard) 设为 ON。
J 连接行ON若要使用 Smart join 行为,需要先在 Behavior options 中将 Smart join 设为 ON。

Table commands(新增表格相关命令)​

有一个 Apply both 按钮,可以同时将 Table structure 和 Table navigation 设为 ON。(当两者都已经是 ON 时,该按钮会处于禁用状态。)

开关默认值说明
Space t Table structure(16 个命令)OFF启用用于表格结构操作的命令。
详见 命令参考。
Space t Table navigation(6 个命令)OFF启用用于在单元格之间移动光标的命令。
详见 命令参考。
Leader 键OFF
(Space)
选择 Table structure 和 Table navigation 所使用的 Leader 键。只有其中一项为 ON 时才有意义。

OFF: Space(默认)。原本空格键的动作(向右移动)将无法使用。
ON: 反斜杠(\)。空格键的动作仍可照常使用。

Behavior options(行为选项)​

将上方部分开关扩展为更加兼顾 Markdown 语法的行为。

For everyone、Vim mode、macOS (Emacs) style 中名称相同的设置项是联动的:在其中一处设为 ON(或 OFF),另一处也会同步变为 ON(或 OFF)。

设置默认值说明
Smart home (standard)ONON: 按下 ^ 会跳过行首的 Markdown 语法(列表、编号列表、复选框、缩进、引用),移动到正文文本的开头。I 会在该位置进入插入模式。

OFF: ^ 不考虑 Markdown 语法,移动到行首的第一个非空白字符。I 会在该位置进入插入模式。
Smart home (advanced)ONON: ^/I 的光标移动位置,除 Smart home (standard) 所考虑的 Markdown 语法外,还会额外考虑标题(#)、脚注([^1]:)、标注类型标记([!type])。仅当 Smart home (standard) 为 ON 时才能开启。

OFF: 不考虑标题行、脚注、标注。
Smart joinOFFON: 使用 J 连接两行时,会删除下一行开头的 Markdown 语法。
需要 Smart home (standard) 为 ON。
除删除引用标记、列表标记、缩进外,若 Smart home (advanced) 为 ON,还会删除标题和脚注。

OFF: 连接时只删除下一行开头的空白。

无论 ON/OFF,连接时都会插入 1 个空格。
Table-aware Source Mode editingONON: 在源代码模式的表格内,<leader>tx / <leader>tX(脱出表格)以及 HOME / END、Kill line、Kill region / Copy region、Yank、Delete char、Transpose chars、Uppercase / Lowercase / Capitalize word、Kill word left / right、Select all 等命令都会考虑表格结构(| / <br>)。

OFF: 将表格行作为纯文本处理,这些命令完全不考虑表格结构。