在VSCode中优雅地编写和预览Markdown文档

2次阅读

vscodemarkdown 无需繁多插件,善用内置预览与基础配置即可获得流畅体验:启用自动保存、段落留白、双击预览等设置,并按需搭配 Markdown All in One 或 Preview Enhanced 插件。

在 VSCode 中优雅地编写和预览 Markdown 文档

在 VSCode 中写 Markdown,不用装一 插件也能很舒服——关键是把基础配置和常用技巧用对。

自带预览足够好用

VSCode 内置的 Markdown 预览功能其实很稳,按 Ctrl+Shift+Vwindows/linux)或 Cmd+Shift+VmacOS)就能侧边实时预览。支持表格、代码块、列表、数学公式(需启用 markdown.math.enabled)、目录([TOC] 需插件,但标题层级渲染原生就支持)。

  • 双击预览窗口可进入专注阅读模式
  • 右键预览区 →“Open Preview to the Side”可固定预览面板
  • 编辑时滚动,预览自动同步对应位置(默认开启)

让写作体验更顺手的几个设置

打开设置(Ctrl+,),搜索并勾选这些选项:

  • “Markdown: Preview Breaks” → 开启后段落间留空行,预览更透气
  • “Markdown: double Click To Open Preview” → 点击编辑器内任意 Markdown 文件直接唤出预览
  • “Files: auto Save” → 设为 afterDelay,避免手动 Ctrl+S 打断思路
  • 禁用 “Markdown: Preview Front Matter”(除非你真用 YAML 头信息)

轻量但实用的插件推荐

真需要增强,只装这 2 个就够了:

  • Markdown All in One:快捷键补全(如 Ctrl+Enter 插入链接 / 图片)、自动更新 TOC、一键导出 html/pdf
  • Markdown Preview Enhanced:适合稍重需求——支持 PlantUML、Mermaid 图表、LaTeX 数学式本地渲染、PDF 导出带样式

两个插件不冲突,可共存;日常写作用前者,技术文档配图用后者。

小技巧提升效率

不用记太多快捷键,掌握这几个就够日常流转:

  • Ctrl+K V:在当前编辑器下方开启嵌入式预览(适合小屏或快速核对)
  • Ctrl+Shift+P → 输入“Markdown: Toggle Preview”切换预览开关
  • 输入 [toc] 后按 Ctrl+Shift+P →“Create table of Contents”,自动生成标题导航
  • 选中文本 → Ctrl+Shift+P →“Markdown: Insert Link”快速转成链接

基本上就这些——不复杂但容易忽略,调好一次,以后每篇笔记都清爽。

站长
版权声明:本站原创文章,由 站长 2025-12-21发表,共计1036字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
1a44ec70fbfb7ca70432d56d3e5ef742
text=ZqhQzanResources