webstorm默认不双击预览markdown，须手动调出markdown preview面板：windows/linux按ctrl+shift+p、macos按cmd+shift+p输入并回车，或右键选open preview（非open in browser），且需确保markdown插件已启用并重启ide。
WebStorm默认不双击预览Markdown，必须手动唤出Preview面板
双击.md文件只打开源码编辑器，不是Bug，是设计行为。WebStorm不会把.md文件当作“可直接渲染的网页”处理，而是依赖Markdown Preview面板按需渲染。你得主动触发它，而不是等IDE自动跳转。
- 快捷键唤起：Windows/Linux用
Ctrl+Shift+P，macOS用Cmd+Shift+P，输入Markdown Preview回车 - 右键菜单唤起：在项目视图或编辑器标签上右键 → 选
Open Preview（⚠️不是Open in Browser） - 确认
Markdown插件已启用：Settings → Plugins → 搜索Markdown→ 勾选并重启IDE - 如果菜单里没出现
Open Preview，说明插件被禁用或损坏，重装插件后务必重启
为什么Open in Browser打不开Markdown渲染效果
Open in Browser只是把原始.md文本丢给Chrome/Firefox，浏览器不解析Markdown语法，结果要么是纯文本乱码，要么直接下载文件。这不是WebStorm的问题，是HTTP协议和浏览器能力的天然限制。
- 所有扩展语法失效：Mermaid图表、数学公式、GFM表格、内部链接都变成普通文字
- 本地图片路径（如
）404，因为file://协议不支持相对路径解析 - 真要浏览器预览，只能走导出路径：右键 →
Export to HTML→ 手动打开生成的.html文件 - 追求热更新？装
Markdown Navigator插件，它会起本地服务，保存即刷新，但会与原生插件冲突，建议卸载原生插件后再装
预览样式丑、Mermaid不显示、中文乱码怎么调
这些问题基本都指向两个地方：渲染引擎选错 + 编码/插件没配齐。WebStorm原生Markdown插件默认用Java写的简易解析器，对现代语法支持弱，且样式不可控。
- 进Settings → Languages & Frameworks → Markdown → Renderer选
Flexmark（比CommonMark兼容性更好） - 勾选
Enable extended syntax和Enable Mermaid support；后者需额外安装Mermaid插件，并在设置里填Mermaid CLI路径（如/usr/local/bin/mmdc） - 中文方块字？看右下角状态栏编码是否为
UTF-8，不是就点开切换；别用GBK保存.md文件 - 想换字体或改代码块背景？在项目根目录放
markdown.css，然后在上述设置页里指定该路径
分屏编辑+预览怎么配才不卡顿
别强行拖拽成左右“硬分屏”，那是反模式。WebStorm的预览面板本质是浮动容器，吸附位置和缩放逻辑跟编辑器独立，强行固定比例反而容易失焦或渲染延迟。
- 唤出
Markdown Preview后，点击面板右上角Editor/Preview按钮切双栏模式 - 点分屏图标（两个重叠方块）选
Horizontal——对笔记本或竖屏更友好，避免横向滚动 - 拖动分隔线调节高度，用
Ctrl+Mouse Wheel（macOS同理）缩放预览字体，别调系统DPI - 勾选
Sync scroll in the editor and preview，否则滚动编辑器时预览不动，对照效率低 - 关闭
Autoscroll to source，否则Project工具窗口高亮跳来跳去，干扰专注
Mermaid图表首次加载慢、预览偶尔空白，大概率是CLI路径没配对或Node版本太老——检查终端执行mmdc -V是否返回版本号，不是就重装Mermaid CLI。
