MarkText Linux 键盘快捷键完全指南:默认绑定对照表与 keybindings.json 自定义实践

原创2026-09-17 10:01:131,868 阅读
文章标签:桌面应用富文本跨平台

MarkText Linux 键盘快捷键完全指南:默认绑定对照表与 keybindings.json 自定义实践

本篇技术指南以 MarkText 官方文档 KEYBINDINGS_LINUX.md 为主体,完整梳理 Linux 平台下 MarkText 的全部默认快捷键(涵盖 File、Edit、Paragraph、Format、Window、View 六大菜单以及标签页切换等非菜单快捷键),并结合仓库源码 keybindingsLinux.ts 与 shortcutHandler.ts 剖析 keybindings.json 的加载、校验与冲突处理机制。读完本文,你将能熟练使用 MarkText 的快捷键体系,并能在 Linux 上自行覆盖任意默认绑定,打造符合个人习惯的编辑环境。

一、先理解快捷键体系的三个概念

在查阅表格之前,需要先建立三个基本概念,它们贯穿所有快捷键的使用与自定义:

  1. 命令 ID(Id):每个快捷键背后都是一个以 菜单名.动作名 命名的命令标识符,例如 file.save、paragraph.heading-1、tabs.cycleForward。所有命令 ID 在源码 constants.ts 中以常量形式集中定义,是自定义配置中的「键名」。
  2. 默认绑定(Default):随安装版本内置的加速键(accelerator),Linux 平台的全部默认绑定定义在 keybindingsLinux.ts 中,按平台在运行时被选中加载。
  3. 自定义覆盖:所有快捷键都可以通过用户数据目录下的 keybindings.json 覆盖,覆盖规则见 KEYBINDINGS.md 与本文第四、五节。

Linux 平台的默认绑定由 shortcutHandler.ts 的 getDefaultKeybindings() 根据 isLinux 判断后选用,因此本文表格与源码映射表一一对应,可交叉验证。

二、菜单内置快捷键(Menu Key Bindings)

以下快捷键出现在 MarkText 的应用程序菜单中,菜单模板(menu/templates)在构建时通过 keybindings.getAccelerator(id) 动态读取当前生效的绑定并显示在菜单项右侧,因此自定义后的快捷键会同步反映到菜单显示上。

2.1 File 菜单

Id 默认快捷键 说明
file.new-window Ctrl+N 新建窗口
file.new-tab Ctrl+T 新建标签页
file.open-file Ctrl+O 打开 Markdown 文件
file.open-folder Ctrl+Shift+O 打开文件夹
file.save Ctrl+S 保存
file.save-as Ctrl+Shift+S 另存为…
file.export-file.pdf Ctrl+Alt+E 将文件导出为 PDF
file.move-file - 将当前文件移动到其他位置
file.rename-file - 重命名当前文件
file.print - 打印当前标签页
file.preferences Ctrl+, 打开设置窗口
file.close-tab Ctrl+W 关闭标签页
file.close-window Ctrl+Shift+W 关闭窗口
file.quit Ctrl+Q 退出 MarkText

2.2 Edit 菜单

Id 默认快捷键 说明
edit.undo Ctrl+Z 撤销上一步操作
edit.redo Ctrl+Shift+Z 重做上一步操作
edit.cut Ctrl+X 剪切选中文本
edit.copy Ctrl+C 复制选中文本
edit.paste Ctrl+V 粘贴文本
edit.copy-as-rich Ctrl+Shift+C 以 Markdown 形式复制选中文本
edit.copy-as-html - 以 HTML 形式复制选中文本
edit.paste-as-plaintext Ctrl+Shift+V 以纯文本形式粘贴
edit.select-all Ctrl+A 全选文档文本
edit.duplicate Ctrl+Shift+E 复制当前段落
edit.create-paragraph Ctrl+Shift+N 在当前段落之后新建段落
edit.delete-paragraph Ctrl+Shift+D 删除当前段落
edit.find Ctrl+F 在文档中查找
edit.find-next F3 继续查找下一个匹配项
edit.find-previous Shift+F3 继续查找上一个匹配项
edit.replace Ctrl+R 查找并替换
edit.find-in-folder Ctrl+Shift+F 在已打开的文件夹中查找包含关键词的文件

2.3 Paragraph 菜单

Id 默认快捷键 说明
paragraph.heading-1 Ctrl+Shift+1* 将当前行设置为一级标题
paragraph.heading-2 Ctrl+Shift+2* 将当前行设置为二级标题
paragraph.heading-3 Ctrl+Shift+3* 将当前行设置为三级标题
paragraph.heading-4 Ctrl+Shift+4* 将当前行设置为四级标题
paragraph.heading-5 Ctrl+Shift+5* 将当前行设置为五级标题
paragraph.heading-6 Ctrl+Shift+6* 将当前行设置为六级标题
paragraph.upgrade-heading Ctrl+Plus 提升标题级别
paragraph.degrade-heading Ctrl+- 降低标题级别
paragraph.table Ctrl+Shift+T 插入表格
paragraph.code-fence Ctrl+Shift+K 插入代码块
paragraph.quote-block Ctrl+Shift+Q 插入引用块
paragraph.math-formula Ctrl+Alt+M 插入数学公式块
paragraph.html-block Ctrl+Alt+H 插入 HTML 块
paragraph.order-list Ctrl+G 插入有序列表
paragraph.bullet-list Ctrl+H 插入无序列表
paragraph.task-list Ctrl+Shift+X 插入任务列表
paragraph.loose-list-item Ctrl+Shift+L 将列表项转换为宽松列表项
paragraph.paragraph Ctrl+Shift+0 将标题转换为普通段落
paragraph.horizontal-line Ctrl+_ 插入水平分割线(即 Ctrl+Shift+-)
paragraph.front-matter Ctrl+Shift+Y 插入 YAML frontmatter 块

* 表格中的标题快捷键以官方文档记载为准;需要说明的是,仓库当前源码 keybindingsLinux.ts 中 paragraph.heading-1~heading-6 实际定义为 Ctrl+Alt+1~Ctrl+Alt+6,与文档存在出入,且该文件头部注释明确建议 Linux 下避免使用 Ctrl+Alt(详见第六节)。如果你发现按键无响应,请打开「设置」窗口查看当前版本实际显示的绑定,或通过 keybindings.json 显式覆盖为符合直觉的组合键。

2.4 Format 菜单

Id 默认快捷键 说明
format.strong Ctrl+B 将选中文本设为粗体
format.emphasis Ctrl+I 将选中文本设为斜体
format.underline Ctrl+U 为选中文本添加下划线
format.superscript - 将选中文本设为上标(源码中无默认绑定)
format.subscript - 将选中文本设为下标(源码中无默认绑定)
format.highlight Ctrl+Shift+H 用 <mark> 标签高亮选中文本
format.inline-code Ctrl+Y 将选中文本设为行内代码
format.inline-math Ctrl+Shift+M 将选中文本设为行内公式
format.strike Ctrl+D 为选中文本添加删除线
format.hyperlink Ctrl+L 插入超链接
format.image Ctrl+Shift+I 插入图片
format.clear-format Ctrl+Shift+R 清除选中文本的格式

2.5 Window 菜单

Id 默认快捷键 说明
window.minimize Ctrl+M 最小化窗口
window.toggle-always-on-top - 切换「窗口置顶」模式
window.zoomIn - 放大
window.zoomOut - 缩小
window.toggle-full-screen F11 切换全屏模式

2.6 View 菜单

Id 默认快捷键 说明
view.command-palette Ctrl+Shift+P 切换命令面板
view.source-code-mode Ctrl+E 切换到源码模式
view.typewriter-mode Ctrl+Shift+G 启用打字机模式
view.focus-mode Ctrl+Shift+J 启用专注模式
view.toggle-sidebar Ctrl+J 切换侧边栏
view.toggle-tabbar Ctrl+Shift+B 切换标签栏
view.toggle-toc Ctrl+K 切换目录(TOC)
view.toggle-dev-tools Ctrl+Alt+I 切换开发者工具(仅调试模式)
view.dev-reload Ctrl+F5 重载窗口(仅调试模式)
view.reload-images F5 重载图片

三、非菜单快捷键(Available Key Bindings)

这部分快捷键不显示在应用程序菜单中,同样在 keybindingsLinux.ts 中注册,用于标签页管理与快速打开文件。

3.1 标签页(Tabs)

Id 默认快捷键 说明
tabs.cycle-forward Ctrl+Tab 循环切换到下一个标签页
tabs.cycle-backward Ctrl+Shift+Tab 循环切换到上一个标签页
tabs.switchToleft Ctrl+PageUp 切换到左侧标签页
tabs.switchToright Ctrl+PageDown 切换到右侧标签页
tabs.switchTofirst Ctrl+1 切换到第 1 个标签页
tabs.switchTosecond Ctrl+2 切换到第 2 个标签页
tabs.switchTothird Ctrl+3 切换到第 3 个标签页
tabs.switchTofourth Ctrl+4 切换到第 4 个标签页
tabs.switchTofifth Ctrl+5 切换到第 5 个标签页
tabs.switchTosixth Ctrl+6 切换到第 6 个标签页
tabs.switchToseventh Ctrl+7 切换到第 7 个标签页
tabs.switchToeighth Ctrl+8 切换到第 8 个标签页
tabs.switchToninth Ctrl+9 切换到第 9 个标签页
tabs.switchTotenth Ctrl+0 切换到第 10 个标签页

3.2 其他(Misc)

Id 默认快捷键 说明
file.quick-open Ctrl+P 显示快速打开对话框

四、用 keybindings.json 覆盖任意快捷键

所有快捷键均可通过用户数据目录下的 keybindings.json 文件覆盖,该文件位置遵循 应用数据目录说明:

  • Linux:$XDG_CONFIG_HOME/marktext 或 ~/.config/marktext
  • Windows:%APPDATA%\marktext
  • macOS:~/Library/Application Support/marktext
  • 便携模式下(参见 PORTABLE.md):位于 --user-data-dir 参数指定的目录或 marktext-user-data 目录

文件内容为 JSON 格式的「命令 ID / 加速键」键值对,官方示例(来自 KEYBINDINGS.md):

{
  "file.save": "CmdOrCtrl+Shift+S",
  "file.save-as": "CmdOrCtrl+S"
}

注意 CmdOrCtrl 是跨平台写法:在 macOS 上解析为 Cmd,在 Linux/Windows 上解析为 Ctrl,源码实现见 keybinding/index.ts 中的 _normalizeAccelerator。如果你只关心 Linux,直接写 Ctrl+Shift+S 即可。

4.1 可用修饰键与按键

  • 修饰键:Ctrl、Shift、Alt(macOS 另有 Cmd、Option,其中 Alt 与 Option 等价);不要绑定 AltGr,请改用 Ctrl+Alt 组合。
  • 普通键:0-9、A-Z、F1-F24 以及 /、# 等标点符号。
  • 功能键:Plus、Space、Tab、Backspace、Delete、Insert、Return/Enter、Esc、Home、End、PrintScreen。
  • 方向与翻页键:Up、Down、Left、Right、PageUp、PageDown。
  • 特殊值:空字符串 "" 用于取消某个命令的默认快捷键(解除绑定)。

4.2 加载与校验过程(源码级)

自定义配置的加载逻辑位于 shortcutHandler.ts 的 _loadLocalKeybindings(),大致流程如下:

  1. 启动时检查 userDataPath/keybindings.json 是否存在,不存在则直接使用默认绑定(安全模式下同样跳过加载)。
  2. 解析 JSON 后,只接受「命令 ID 存在于默认映射中」且「值合法」的条目:空字符串表示解绑;非空值必须通过 isValidElectronAccelerator() 校验,非法值会输出 [WARNING] "... " is not a valid accelerator. 日志并被忽略。
  3. 重复检测:若用户配置内部出现两个命令绑定到同一加速键,会被判定为无效配置并整体放弃加载。
  4. 冲突处理:如果用户把某个加速键赋给新命令,原来使用该加速键的默认命令会被自动解除绑定(置空),避免一个按键触发多个动作。等价性比较通过 keybinding/index.ts 的 isEqualAccelerator 完成(会忽略 CmdOrCtrl/Ctrl、Control/Ctrl 等写法差异)。

加载完成后,快捷键通过 electronLocalshortcut 注册到各个 BrowserWindow(shortcutHandler.ts),并在按键事件中先于 Chromium 原生菜单处理并阻止默认行为;同时菜单模板通过 getAccelerator(id) 读取最新绑定并显示。也就是说:修改 keybindings.json 并重启 MarkText(或通过设置面板调整)后,菜单上显示的快捷键文字会同步更新。

五、Linux 平台的专属注意事项

在自定义 Linux 快捷键时,务必留意源码文件头部的三条平台约束(keybindingsLinux.ts):

  1. 避免 Ctrl+Alt 与单独的 Alt 组合:基于 Ubuntu 的系统为这些组合保留了系统级快捷键(详见仓库 GH#2370 相关讨论),绑定后会出现按键行为异常。这也是源码注释不建议在 Linux 默认绑定中使用 Ctrl+Alt 的原因。
  2. 不要使用 Ctrl+Shift+U:该组合被 IBus 用于 Unicode 输入,会被输入法框架拦截。
  3. 避免绑定可用 ^ 或 ` 组合产生的字符:在部分键盘布局(如德语无死键键盘)上无法确定死键字符,Ctrl+`` (即 Ctrl+Shift+´)一类绑定无法被正确解析。一般建议不要给 ^、`、"、~ 等字符绑定默认快捷键。

此外,MarkText 会通过 keyboard/index.ts 中的 native-keymap 获取当前键盘布局与键位映射,并在布局切换时自动更新快捷键解析(keyboardLayoutMonitor 以 150ms 防抖监听布局变化),从而尽量保证非美式键盘(如德语、法语键盘)上快捷键仍可用;该模块还提供 mt::keybinding-debug-dump-keyboard-info IPC,可把键盘信息 JSON 写入临时目录辅助排障。

六、关联文档速查

实践建议:初次使用可直接对照本文第二、三节表格快速上手;当某个默认组合与桌面环境冲突(例如需要抢回被系统占用的按键)时,编辑 ~/.config/marktext/keybindings.json,按第四节格式写入覆盖条目,必要时用空字符串解除冲突键位,重启后即可生效。

登录后查看全文
marktext