VS Code可通过三个核心插件(Markdown All in One、Markdown Preview Mermaid Support、Code Spell Checker)和三项关键配置(禁用自动预览、手动唤出、图片自动存入assets)打造高效Markdown环境。

VS Code 本身不是 Markdown 编辑器,但通过合理配置和插件组合,它能成为目前最灵活、可定制性最强的 Markdown 工作环境——前提是避开默认设置里的几个典型陷阱。
安装哪些插件才真正有用
别装“Markdown All in One”+“Preview Enhanced”+“Paste Image”这种堆砌式组合。多数人只需要三个核心插件:
-
Markdown All in One:提供快捷键(如Ctrl+Shift+V双窗格预览)、目录生成(Ctrl+K Ctrl+T)、自动补全(##后按Tab补标题层级) -
Markdown Preview Mermaid Support:让mermaid图表在预览中直接渲染,不用额外配 Webview 或导出 -
Code Spell Checker:专为技术文档优化的拼写检查,支持忽略代码块、行内代码(`包裹内容)和 YAML frontmatter
其他如“Markdown PDF”或“Markdown Emoji”属于一次性需求工具,用时再装更省资源。
预览窗口卡顿、刷新延迟怎么办
VS Code 内置预览默认监听整个工作区,文件一多就卡。根本解法是关掉自动刷新,改用手动触发:
这本书假定你没有任何关于脚本或一般程序的编程知识, 但是如果你具备相关的知识, 那么你将很容易就能够达到中高级的水平. . . 所有这些只是UNIX®浩瀚知识的一小部分. 你可以把本书作为教材, 自学手册, 或者是关于shell脚本技术的文档. 书中的练习和样例脚本中的注释将会与读者进行更好的互动, 但是最关键的前提是: 想真正学习脚本编程的唯一途径就是亲自动手编写脚本. 这本书也可作为教材来讲解一般的编程概念. 向伟大的中华民族的Linux用户致意! 我希望这本书能够帮助你们学习和理解L
- 在
settings.json中添加:"markdown.preview.autoShowPreviewPanel": false - 用快捷键
Ctrl+K V(Windows/Linux)或Cmd+K V(macOS)按需唤出预览面板 - 禁用
"markdown.preview.doubleClickToSwitchToEditor",避免误点退出编辑模式 - 如果文档含大量 mermaid 或数学公式,建议关闭
"markdown.preview.mathjax": true,改用 KaTeX(需额外配置)提升加载速度
图片插入总要手动改路径?
VS Code 默认不处理图片粘贴和相对路径。关键设置在 settings.json 里两处:
-
"markdown.extension.italic.indicator": "_"这类无关项不用动;重点是:"markdown.extension.imageUploader.action": "copy" - 配合
"markdown.extension.imageUploader.uploadMethod": "none",粘贴图片时自动存入./assets/并插入相对路径(如) - 确保工作区根目录下有
assets/文件夹,否则会报错Unable to write file ... Permission denied - 别依赖“从资源管理器拖拽图片”,它生成的是绝对路径,跨设备即失效
真正影响效率的从来不是功能多少,而是每次插入图片、更新目录、导出 PDF 时是否要打断思路去查文档或调设置。把上面三处配好,剩下的就是写。







