按 F2,就地编辑:点哪段改哪段

用 mdview 打开任意 .md 文件后,按 F2 就进入就地编辑模式。也可以从右键菜单 → 编辑 → 就地编辑进入。再按一次 F2 或按 Esc 则退出(退出前自动提交并保存当前修改)。

这个模式不分屏:页面还是原来的渲染效果,但每个块都变得可以点——点某段文字、某个标题、某张表格,它就在原位置变成可编辑状态,改完点下一块,上一块立刻渲染回去。体验类似 Typora / Obsidian 的所见即所得:

  • 标题里输入 # 加空格,立即渲染成大标题,# 前缀灰显,退格还能删回去;
  • 表格直接像 Excel 一样点单元格改,Tab 跳下一格,末格再按 Tab 自动加一行;
  • 停笔约 1 秒自动保存,不用惦记着按 Ctrl+S
  • 光标在块首按 、块尾按 ,直接在块与块之间穿梭。

改一两个字、顺手补条 Todo,用这个最舒服。更多玩法见就地编辑那篇

按 F3,分屏编辑:左源码右预览

F3 进入分屏编辑模式,也可以从右键菜单 → 编辑 → 分屏编辑进入。再按一次 F3 或按 Esc 则退出(退出后会刷新一次,回到纯阅读视图并显示最新内容)。

进入后界面会变成左右分屏

  • 左侧:源码编辑区,带行号,字体、字号跟右侧正文一致,两边内容分布对得上;
  • 中间:一条可拖拽的分隔条,鼠标拖动就能调整左右栏宽;
  • 右侧:实时预览,渲染出来的样子和正常阅读时一模一样。

快捷键速查表

这是本篇的核心。两种模式一致的快捷键已经合并在一行,标「—」表示该模式里没有这个键(Mac 上 Ctrl 对应 Cmd):

快捷键F2 就地编辑F3 分屏编辑
F2进入 / 退出就地编辑切换到就地编辑
F3切换到分屏编辑进入 / 退出分屏编辑
Esc提交当前块并退出保存并退出
Ctrl + S立即保存(平时停笔 1 秒自动保存)立即保存(同左,也会自动保存)
Ctrl + T插入表格插入表格片段
Tab片段补全,未命中则缩进;表格内跳下一格片段补全,未命中则插入缩进
Ctrl + B / I / U粗体 / 斜体 / 下划线
Ctrl + Shift + X删除线
Ctrl + K插入链接(选中网址则自动包成链接)
Ctrl + L列表循环:普通文字 → 无序 → 有序 → Todo插入链接
Ctrl + I斜体插入图片(选中图片路径则自动包成图片)
Ctrl + Enter提交当前块(继续改下一块)
↑ / ↓光标在块首 / 块尾时跳到上一块 / 下一块
Enter标题内回车另开新段落;空列表项回车升一级 / 退出列表换行,自动保留缩进并延续列表
Ctrl + Z / Ctrl + Shift + Z撤销 / 重做(块级提交也能回退)撤销 / 重做

片段补全:输入关键词,按 Tab 一键生成

这是两种模式共有的省事功能。先输入一个关键词,再按 Tab,编辑器会把它展开成对应的代码片段,并把光标停在每个要填的位置:

  • table + Tab → 展开成一个表格模板(含表头、分隔行、示例单元格);
  • link + Tab → 展开成 [描述](url)
  • img(或 image)+ Tab → 展开成 ![alt](url)
  • F2 就地编辑还多一些:note / tip / important / warning / caution + Tab → 展开成对应的 GFM 提示块。

不想用补全时,Tab 就老老实实插入缩进。表格怎么调对齐,可以看表格那篇

别按串了:Ctrl+LCtrl+I 在两种模式里含义不同——F3 分屏里 Ctrl+L 插链接、Ctrl+I 插图片(先选中一段网址或图片路径再按,会直接包成链接 / 图片);F2 就地编辑里 Ctrl+L 是列表循环、Ctrl+I 是斜体,插链接要用 Ctrl+K

保存与预览刷新

两种模式都会自动保存——停笔约 1 秒就会静默写入文件,想立即落盘也可以随时按 Ctrl + S。F2 就地编辑保存后当前块原地渲染回去,页面不闪不跳;F3 分屏编辑保存后右侧预览随即无感刷新,左侧的编辑状态和光标位置都不会丢。也就是说,你可以放心地反复「改一段 → 看效果」。

按章节双向滚动同步(分屏模式)

F3 分屏模式下,长文档里左右两边会按章节自动对齐滚动:在左边编辑某一段,右边预览会跟着滚到对应位置;反过来在右边预览里滚动,左边源码也会跟上。这样改哪个章节,眼睛不用来回找。

如果拖动过分隔条改了栏宽,编辑区换行会变化,滚动同步也会自动重新校准,不用手动处理。

顺带一提:外部编辑器

内置编辑器适合「读着读着改两笔」。如果你要长时间写、或需要更强大的编辑能力,mdview 还能调用本机外部编辑器

  • F4 调用外部编辑器;
  • 选中一段文字按 Ctrl + E,会用外部编辑器打开并定位到对应行。

外部编辑器保存后,mdview 会自动刷新预览。三种方式搭配:顺手改两笔用 F2 就地编辑,写整段内容用 F3 分屏编辑,大段创作用 F4 外部编辑器。

小结

记住四件事就能把内置编辑器用顺:

  • F2 就地编辑:点哪段改哪段,所见即所得,改一两个字最顺手;
  • F3 分屏编辑:左源码右预览,写整段内容用;两个模式按 F2 / F3 可直接互切;
  • 两种模式都自动保存Ctrl+S 只是立即落盘;
  • 关键词 + Tab 补全表格 / 链接 / 图片,长文档靠章节滚动同步,改哪里看哪里。

还没装 mdview?去 官网下载页装一个,随便打开个 .md 文件按 F2 或 F3 试试。