写接口文档时一直在按快捷键开预览,改一句切一次,来回几十遍。VS Code 本身没有真正的所见即所得,只有渲染预览。
内置的侧边预览够用了
先按 Ctrl+K 再按 V,右边开一栏实时预览,滚动同步,左边改右边立刻变。命令面板里搜 Markdown 打开侧边预览也是同一个功能。想让它顺手,装个 Markdown All in One,列表自动续写、目录生成、格式化都有了。
单栏编辑为什么做不出来
编辑器核心是纯文本的,渲染跑在 webview 里,两者不同步到字符级,所以做不出光标所在行才显示源码的效果。市面上标着所见即所得的扩展,多数是打开一个 webview 让你在里面写,代价是查找替换、Git 差异、引用跳转都会打折。
- 只写文档、单栏体验优先,用专门的 Markdown 客户端更舒服。
- 文档和代码放在同一个仓库,别折腾,侧边预览加同步滚动就够。
- 要频繁贴图,配一个图床工具,粘贴后自动上传。
图片和表格的短板
预览里的图片按原始尺寸渲染,大图会把版面撑开,得自己限一个最大宽度。表格更麻烦,列宽由内容决定,对齐方式只能在源码里用冒号控制。写复杂文档时这两点会反复打断思路。
想导出 PDF,预览右键里就能打印,但页眉页脚和分页位置都不好控,正式文档还是交给专门的排版工具。
两个设置能少受点罪
把 editor.wordWrap 设成 on,长段落不再横向滚动。markdown.preview.breaks 打开后,单个换行也会渲染成换行,写惯了单栏客户端的人觉得顺手,但和别人的渲染结果可能不一致,团队协作时慎改。
协作还有个坑:不同编辑器对换行和空格的解释不一样,同一条列表可能一边渲染成三条,另一边挤成一条。提交前用统一的格式化工具过一遍,能省掉不少争论。
我的判断:写稿用所见即所得的工具,仓库里的 md 用侧边预览校对格式,别指望一个编辑器全包。