vscode可通过配置插件和设置成为高效markdown笔记工具:支持实时预览、目录导航、双向链接、标签管理、图片插入及pdf/html导出。必备插件包括Markdown All in One、Preview Enhanced、Paste Image和Todo Tree;关键设置有自动保存、预览跟随滚动等;配合YAML标签、双括号链接与图谱插件可模拟Obsidian体验。

VSCode 本身不是笔记软件,但通过合理配置插件和设置,完全可以变成一个高效、美观、功能丰富的 Markdown 笔记工具——支持实时预览、目录导航、双向链接、标签管理、本地图片插入、导出 PDF/HTML,甚至类 Obsidian 的体验。
必备插件:让基础功能跑起来
安装这几个核心插件,是打造 Markdown 工作流的第一步:
- Markdown All in One:自动补全标题、列表、引用;快捷键一键生成目录(
Ctrl+Shift+P→ “Markdown: Create table of Contents”);支持数学公式、流程图(需启用);按Ctrl+K Ctrl+V快速唤起侧边预览。 - Markdown Preview Enhanced:比原生预览更强——支持 Mermaid 图表、LaTeX 渲染、PDF/HTML 导出、幻灯片模式、自定义 css 样式。右键预览窗口可直接“Open in Browser”或“Export to PDF”。
- Paste Image:粘贴截图时自动保存到指定文件夹(如
./assets/),并插入相对路径图片链接,避免手动拖拽和路径错误。 - Todo Tree:高亮
TODO、FIXME等标记,统一查看所有待办事项,适合在笔记中嵌入任务清单。
提升效率的实用设置
在 VSCode 设置(settings.json)中加入这些配置,让写作更顺手:
- 开启自动保存:
"files.autoSave": "onFocusChange",切换文件时自动存档,不怕意外关闭。 - 默认用 Markdown 预览打开
.md文件:"workbench.editorAssociations": {"*.md": "markdown.preview.editor"}(VSCode 1.86+ 推荐用此方式)。 - 让预览跟随编辑滚动:
"markdown.preview.scrollPreviewWithEditor": true,写到哪,右边就看到哪。 - 禁用不必要的语法校验干扰:
"markdown.validate.enabled": false(除非你真需要严格遵循 CommonMark 规范)。
模拟 Obsidian 风格:链接与知识图谱
不需要换软件,也能获得类似体验:
- 用双括号创建内部链接:
[[会议纪要202405]]或[[项目计划#需求分析]],配合插件 Markdown Notes 或 Quick Note 可一键跳转、快速新建笔记。 - 用 Markdown Links 插件可批量检查断链、可视化链接关系。
- 想看知识图谱?装 Markdown Graph,它会在侧边栏生成当前文件的引用网络图(基于
[[xxx]]和![[xxx]])。 - 标签系统靠约定:在每篇笔记顶部加 YAML Front Matter,例如:
---<br>tags: [学习, python, 工具<br>---
再用 Tag Explorer 插件统一筛选和跳转。
进阶技巧:本地化 + 自动化
真正把笔记变成“个人知识库”,还得靠一点小自动化:
- 用 File Watcher 或 Shell Command 插件,在保存 .md 时自动运行脚本,比如:压缩图片、同步到云盘、生成摘要索引。
- 配合 Plantuml 插件,在笔记里直接写 UML 文字描述,实时渲染类图、时序图,技术笔记立刻变专业。
- 用 Markdown Emoji 插件输入
:heart:就自动转为 ❤️,给笔记加点温度。 - 导出 PDF 时想更美观?在
settings.json中配置"markdown-preview-enhanced.enableScriptExecution": true,再写个简单 CSS 注入,就能定制字体、页眉页脚、代码块样式。
基本上就这些。不复杂,但容易忽略细节。关键是选好 3–4 个最契合你习惯的插件,配好 5 条核心设置,再坚持用一个月——你的 VSCode 就不再是代码编辑器,而是随时待命的数字笔记本。