Draftail 用户指南：键盘快捷键与自动列表等 10 个免鼠标编辑技巧
【免费下载链接】draftail📝🍸 A configurable rich text editor built with Draft.js项目地址: https://gitcode.com/gh_mirrors/dr/draftail
Draftail 是一款基于 Draft.js 构建的可配置富文本编辑器，专为"免鼠标"设计——绝大多数排版操作都可以纯键盘完成。本文整理 10 个实用编辑技巧，涵盖键盘快捷键、Markdown 风格输入和自动列表，帮你快速上手 Draftail 富文本编辑器。
1. 自动列表：行首输入-或1.秒建列表
Draftail 支持"自动列表（Autolists）"：在行首输入-、*加空格自动变成无序列表，输入1.加空格自动变成有序列表，无需点任何按钮。
这一行为由src/api/behavior.ts中的handleBeforeInputBlockType驱动，映射表定义在src/api/constants.ts的INPUT_BLOCK_MAP中。
2. 回车续写列表，空项自动退出
- 在列表项末尾按Enter，自动创建下一个列表项并继续编号或圆点；
- 当列表项为空时再按Enter，自动跳出列表变回普通段落；
- 对以
-list-item结尾的自定义列表块同样生效。
3. Markdown 风格标题：#到######一行切换
在行首输入#+ 空格得到一级标题，##+ 空格二级标题，依此类推直到######。这是把整行文字转成标题最快的方式，比在工具栏翻找 H1~H6 按钮快得多。
4.```一键转代码块
在行首输入三个反引号```回车，当前行立即变成代码块（参考INPUT_BLOCK_MAP中的"```"条目）。代码块内的换行行为做了特殊处理，不会意外跳出。
5. Markdown 文本格式快捷键：**、_、~~、`
选中文字后输入 Markdown 标记即可自动应用样式，完整映射见src/api/constants.ts的INPUT_STYLE_MAP：
| 输入标记 | 效果 |
|---|---|
**文字**或__文字__ | 粗体 |
*文字*或_文字_ | 斜体 |
~~文字~~或~文字~ | 删除线 |
`文字` | 行内代码 |
6. 经典组合键：B、I、U、J 一个不能少
| 快捷键 | 功能 |
|---|---|
| Ctrl/Cmd + B | 粗体 |
| Ctrl/Cmd + I | 斜体 |
| Ctrl/Cmd + U | 下划线 |
| Ctrl/Cmd + J | 行内代码 |
| Ctrl/Cmd + Shift + X | 删除线 |
| Ctrl/Cmd + . | 上标 |
| Ctrl/Cmd + , | 下标 |
这些绑定在src/api/behavior.ts的getKeyBindingFn中按配置动态启用，未启用的格式不会误触。
7. Ctrl/Cmd + K 快速插入链接
选中文字按Ctrl/Cmd + K直接打开链接编辑弹窗，这是浏览器里约定俗成的"链接快捷键"，从其他编辑器切过来零学习成本。
8. 无限撤销 / 重做：写错也不怕
- Ctrl/Cmd + Z撤销；
- Ctrl/Cmd + Shift + Z重做。
Draftail 提供"直到时间尽头"的撤销栈，误操作可以一路回退，放心大胆编辑。
9. Tab / Shift + Tab 调整列表缩进
- Tab加深列表项嵌套；
- Shift + Tab反方向减少嵌套。
嵌套层级由maxListNesting属性控制，行为稳定、不易"跳层"。
10. Shift + Enter 换行、---插入分隔线
- Shift + Enter在段落内插入软换行，不产生新段落；
- 在空行输入
---自动生成水平分隔线（代码块内除外）。
彩蛋：命令面板（Command Palette）
如果你连工具栏都不想找，Draftail v2 提供了可选的CommandPalette组件（见src/components/CommandPalette/CommandPalette.tsx）：打开面板输入文字即可搜索并执行标题、列表、链接等全部格式命令，完全键盘可控。
快速参考：Draftail 键盘快捷键速查
| 操作 | 快捷键 / 输入 |
|---|---|
| 无序列表 | 行首-或* |
| 有序列表 | 行首1. |
| 标题 1~6 | 行首#~###### |
| 引用块 | 行首> |
| 代码块 | 行首``` |
| 粗体 / 斜体 / 下划线 | Ctrl/Cmd + B / I / U |
| 行内代码 | Ctrl/Cmd + J 或` |
| 删除线 | Ctrl/Cmd + Shift + X 或~~ |
| 上标 / 下标 | Ctrl/Cmd + . / , |
| 链接 | Ctrl/Cmd + K |
| 撤销 / 重做 | Ctrl/Cmd + Z / Shift + Z |
| 软换行 | Shift + Enter |
| 分隔线 | --- |
| 列表缩进 | Tab / Shift + Tab |
掌握以上 10 个技巧，你的鼠标就可以一直留在桌面上休息了。更多细节可参考项目文档目录docs/与主配置文件src/api/constants.ts中的完整快捷键表。
【免费下载链接】draftail📝🍸 A configurable rich text editor built with Draft.js项目地址: https://gitcode.com/gh_mirrors/dr/draftail
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
