唯一可靠唤出 WebStorm Markdown 预览面板的快捷键是 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），其他方式如双击文件、Open in Browser 均无效；预览依赖插件启用、文件类型识别、实时预览设置及 Mermaid 等扩展配置，导出 HTML 是获取真实源码的唯一内置方法。
Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）是唯一可靠唤出预览面板的快捷键
WebStorm 不响应双击 .md 文件打开预览，也不支持用 Open in Browser 直接渲染 Markdown —— 浏览器根本不解析 .md 后缀，只会下载或显示源码。真正起作用的只有 IDE 内置的 Markdown Preview 面板，而它的激活入口就是这个全局命令面板快捷键。
常见错误现象：
- 按了
Ctrl+Shift+P却没反应：多半是快捷键被其他插件（如 Vim 插件）劫持，进Settings → Keymap搜索Markdown Preview确认绑定是否有效 - 输入后找不到
Markdown Preview选项：说明Markdown插件未启用，去Settings → Plugins勾选它并重启 IDE - 面板弹出但内容空白或卡住：检查当前文件是否真被识别为 Markdown（右下角状态栏应显示
Markdown；若显示Text，需手动右键 →Override File Type → Markdown）
预览面板默认不自动显示，且位置/大小需手动调整
它不会像浏览器标签页那样“自动弹出”，而是以浮动面板形式出现在右侧或底部，首次使用时容易误以为“没生效”。面板支持同步滚动和实时刷新，但这些能力依赖两个前提：
-
Settings → Languages & Frameworks → Markdown中勾选了Enable live preview - Mermaid 或数学公式等扩展语法要生效，还需额外启用对应插件（如
Mermaid）并在同页面勾选Enable Mermaid support - 面板尺寸过小会导致表格、代码块换行错乱——拖动边缘扩大宽度，比强行缩放字体更有效
别碰 Open in Browser，除非你已配好转换服务
右键菜单里的 Open in Browser 是个陷阱。它只是把原始 readme.md 文件路径丢给 Chrome/Firefox，结果必然是：
- Chrome 直接触发下载
- Safari / Edge 显示一堆
#和```符号，毫无格式 - 所有
$$数学公式、```mermaid图表、GFM 表格对齐全部失效
真要浏览器热刷新，必须走转换路径：
- 装
Markdown Navigator插件（比原生更稳），它提供Preview in Browser功能，会自动起本地 HTTP 服务并实时转 HTML - 或配置 External Tools：用
markedCLI 工具监听文件变化，配合$FilePath$变量自动生成 HTML 并用浏览器打开
导出 HTML 是获取真实源码的唯一内置方式
预览面板里右键 → View Page Source 或按 Ctrl+U 全部无效——那不是真实 HTML 文档，而是 WebView 渲染后的 DOM 快照。想拿到可调试、可复现的 HTML 字符串，只能：
- 右键 Markdown 文件 →
Export to HTML：生成一个带内联样式的完整 HTML 文件，Mermaid 是否包含取决于插件与设置是否双重启用 - 注意导出路径：默认在同目录，但文件名会加
-export后缀，容易忽略；建议提前在Settings → Languages & Frameworks → Markdown → Export里设好模板和输出目录 - 导出内容 ≠ 编辑器里看到的样式：比如某些主题色、字体来自 IDE 主题，导出 HTML 用的是固定 CSS，若需定制，得改插件的导出模板或用命令行工具
Mermaid 图表是否出现在导出 HTML 里，是检验配置是否完整的最直接标尺——漏掉任一环节（插件未装、支持未勾、语法写错），它就退化成普通代码块。
