Ctrl+滚轮在Markdown预览中无效,需确保预览窗口获得焦点,并启用markdown.preview.scrollEditorWithPreview和markdown.preview.scrollPreviewWithEditor两项设置,且editor.accessibilitySupport设为"auto"或"on"。

Ctrl+滚轮在 Markdown 预览里没反应?先确认焦点和配置
不是快捷键坏了,而是预览窗口根本没获得输入焦点,或关键同步开关被关掉了。VS Code 的 Markdown 预览由独立 WebView 渲染,它不继承主编辑器的缩放行为。
必须同时启用两个设置项,否则滚动(包括 Ctrl+滚轮)完全无效:
-
markdown.preview.scrollEditorWithPreview设为true -
markdown.preview.scrollPreviewWithEditor设为true
这两个选项在设置 UI 里不在同一屏——常有人只开了后者却漏掉前者。另外,editor.accessibilitySupport 必须是 "auto" 或 "on",否则部分缩放手势会被系统级禁用。
操作前务必点击预览区域任意位置,确保光标聚焦在预览面板内;如果焦点还在编辑器,Ctrl+滚轮只会缩放代码字体。
真正生效的缩放操作只有这三种
Markdown 预览的缩放是通过 WebView 的 transform: scale() 实现的,不是改字体大小,所以行为和编辑器不同。以下操作才有效:
-
Ctrl+=或Ctrl+-:对整个预览 WebView 按固定粒度(约 20% 每级)缩放 -
Ctrl+0:重置为markdown.preview.zoomLevel配置值(如设为1.2,就恢复到 120%) - 触摸板双指缩放:macOS / Windows 触控设备原生支持,无需额外配置
注意:Ctrl+滚轮 只有在预览已聚焦的前提下才等效于 Ctrl+=/-;如果用了 Markdown: Open Preview(单标签页命令),它不触发双栏同步逻辑,缩放也不会生效。
实现 Markdown↔ HTML 互转,支持导出 PDF,用于用户请求的文档格式转换。
全局图片缩放要用 CSS,不是 zoomLevel
markdown.preview.zoomLevel 控制的是整个预览页面的缩放比例,对图片尺寸没有精细调节能力。想让所有图片统一显示为 65% 宽度,必须借助扩展 + 自定义 CSS。
安装 Markdown Preview Enhanced 后,按 Ctrl+Shift+P 运行 Markdown Preview Enhanced: Customize Css,在打开的 style.less 文件末尾添加:
.markdown-preview.markdown-preview img {
width: 65% !important;
max-width: 100%;
height: auto;
display: block;
margin: 20px auto;
}
这个规则只作用于屏幕预览;如需导出 PDF 时也生效,还得补上 @media print 块,并用 Chrome (Puppeteer) 引擎导出——否则其他引擎会忽略 @media 查询。
缩放后文字发虚、图片错位?检查渲染层级冲突
预览缩放异常,90% 不是配置问题,而是渲染通路被干扰。常见原因:
- 工作区
.vscode/settings.json里写了window.zoomLevel,覆盖了用户级设置 - 启用了
--disable-hardware-acceleration启动参数,导致 WebView 缩放变换矩阵渲染失真 - Linux Wayland 环境下,
window.zoomLevel对标题栏缩放支持不稳定,但markdown.preview.zoomLevel仍可用 - 同时调高
window.zoomLevel和editor.fontSize,会导致 UI 元素与预览内容比例失调,比如菜单小得看不清,而预览图大得溢出
最稳妥的排查方式:打开命令面板,运行 Developer: Toggle Developer Tools,在 Console 里搜 zoom 或 scale,看是否报出 CSS transform 相关警告——那说明缩放已下发,但渲染层拒绝执行。










