MarkText Linux 键盘快捷键完全指南:默认绑定对照表与 keybindings.json 自定义实践
MarkText Linux 键盘快捷键完全指南:默认绑定对照表与 keybindings.json 自定义实践
本篇技术指南以 MarkText 官方文档 KEYBINDINGS_LINUX.md 为主体,完整梳理 Linux 平台下 MarkText 的全部默认快捷键(涵盖 File、Edit、Paragraph、Format、Window、View 六大菜单以及标签页切换等非菜单快捷键),并结合仓库源码 keybindingsLinux.ts 与 shortcutHandler.ts 剖析 keybindings.json 的加载、校验与冲突处理机制。读完本文,你将能熟练使用 MarkText 的快捷键体系,并能在 Linux 上自行覆盖任意默认绑定,打造符合个人习惯的编辑环境。
一、先理解快捷键体系的三个概念
在查阅表格之前,需要先建立三个基本概念,它们贯穿所有快捷键的使用与自定义:
- 命令 ID(Id):每个快捷键背后都是一个以
菜单名.动作名命名的命令标识符,例如file.save、paragraph.heading-1、tabs.cycleForward。所有命令 ID 在源码 constants.ts 中以常量形式集中定义,是自定义配置中的「键名」。 - 默认绑定(Default):随安装版本内置的加速键(accelerator),Linux 平台的全部默认绑定定义在 keybindingsLinux.ts 中,按平台在运行时被选中加载。
- 自定义覆盖:所有快捷键都可以通过用户数据目录下的
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(),大致流程如下:
- 启动时检查
userDataPath/keybindings.json是否存在,不存在则直接使用默认绑定(安全模式下同样跳过加载)。 - 解析 JSON 后,只接受「命令 ID 存在于默认映射中」且「值合法」的条目:空字符串表示解绑;非空值必须通过
isValidElectronAccelerator()校验,非法值会输出[WARNING] "... " is not a valid accelerator.日志并被忽略。 - 重复检测:若用户配置内部出现两个命令绑定到同一加速键,会被判定为无效配置并整体放弃加载。
- 冲突处理:如果用户把某个加速键赋给新命令,原来使用该加速键的默认命令会被自动解除绑定(置空),避免一个按键触发多个动作。等价性比较通过 keybinding/index.ts 的
isEqualAccelerator完成(会忽略CmdOrCtrl/Ctrl、Control/Ctrl等写法差异)。
加载完成后,快捷键通过 electronLocalshortcut 注册到各个 BrowserWindow(shortcutHandler.ts),并在按键事件中先于 Chromium 原生菜单处理并阻止默认行为;同时菜单模板通过 getAccelerator(id) 读取最新绑定并显示。也就是说:修改 keybindings.json 并重启 MarkText(或通过设置面板调整)后,菜单上显示的快捷键文字会同步更新。
五、Linux 平台的专属注意事项
在自定义 Linux 快捷键时,务必留意源码文件头部的三条平台约束(keybindingsLinux.ts):
- 避免
Ctrl+Alt与单独的Alt组合:基于 Ubuntu 的系统为这些组合保留了系统级快捷键(详见仓库 GH#2370 相关讨论),绑定后会出现按键行为异常。这也是源码注释不建议在 Linux 默认绑定中使用Ctrl+Alt的原因。 - 不要使用
Ctrl+Shift+U:该组合被 IBus 用于 Unicode 输入,会被输入法框架拦截。 - 避免绑定可用
^或`组合产生的字符:在部分键盘布局(如德语无死键键盘)上无法确定死键字符,Ctrl+``(即Ctrl+Shift+´)一类绑定无法被正确解析。一般建议不要给^、`、"、~等字符绑定默认快捷键。
此外,MarkText 会通过 keyboard/index.ts 中的 native-keymap 获取当前键盘布局与键位映射,并在布局切换时自动更新快捷键解析(keyboardLayoutMonitor 以 150ms 防抖监听布局变化),从而尽量保证非美式键盘(如德语、法语键盘)上快捷键仍可用;该模块还提供 mt::keybinding-debug-dump-keyboard-info IPC,可把键盘信息 JSON 写入临时目录辅助排障。
六、关联文档速查
- 跨平台自定义总则:KEYBINDINGS.md
- Linux 默认绑定:KEYBINDINGS_LINUX.md
- macOS 默认绑定:KEYBINDINGS_OSX.md
- Windows 默认绑定:KEYBINDINGS_WINDOWS.md
- 应用数据目录:APPLICATION_DATA_DIRECTORY.md
- 便携模式:PORTABLE.md
- 源码参考:keybindingsLinux.ts、shortcutHandler.ts、constants.ts、keybinding/index.ts
实践建议:初次使用可直接对照本文第二、三节表格快速上手;当某个默认组合与桌面环境冲突(例如需要抢回被系统占用的按键)时,编辑 ~/.config/marktext/keybindings.json,按第四节格式写入覆盖条目,必要时用空字符串解除冲突键位,重启后即可生效。