WebStorm默认用内置Markdown Preview面板实时渲染，不支持双击浏览器预览；需按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）唤出，或右键选Open Preview，确保Markdown插件已启用。
WebStorm 默认不双击打开浏览器预览 Markdown，而是用内置的 Markdown Preview 面板实时渲染——这是最稳定、最集成的方式；强行用浏览器打开原始 .md 文件只会下载或显示源码，不是“预览失败”，是根本走错了路。
怎么唤出 Markdown Preview 面板
默认不自动弹出，需手动触发：
- 快捷键：
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Markdown Preview并回车 - 右键文件 → 选
Open Preview（注意不是Open in Browser） - 如果菜单里没这个选项，说明
Markdown插件被禁用了：进Settings → Plugins，确认已勾选并重启 IDE
面板默认出现在右侧或底部，可拖动调整大小，支持同步滚动和实时刷新——改一行，预览立刻变。
为什么 Open in Browser 不行
浏览器无法原生解析 Markdown；Open in Browser 只是把 readme.md 当作纯文本丢给 Chrome/Firefox，结果通常是：
Telegram Markdown Adapter
下载
将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。
- 直接下载文件（尤其是 Chrome）
- 显示一堆未渲染的
#、```和星号 - 完全不支持 Mermaid、数学公式、表格对齐等扩展语法
真要浏览器预览，必须走转换路径：要么用插件（如 Markdown Navigator 提供的 Preview in Browser，它会起本地服务并自动转 HTML），要么手动导出：Right-click → Export to HTML，再用浏览器打开生成的 .html 文件（但无热更新）。
分屏编辑 + 预览怎么配才顺手
别把 Markdown Preview 面板和编辑器硬凑成“左右分屏”——那是反模式。正确做法是：
- 保持编辑器在主区域，用
Ctrl+Shift+P唤出预览面板，拖到右侧/底部停靠（IDE 自动吸附） - 如需对照多个 Markdown 文件，用标签页右键 →
Split Vertically（左右）或Split Horizontally（上下）；注意必须右键点在文件标签文字上，点空白处会弹错菜单 - 想让预览面板更大？直接拖拽分隔线；想临时隐藏？按
Esc或点面板右上角 × - 若预览样式丑、Mermaid 图不显示：进
Settings → Languages & Frameworks → Markdown，确认启用了Enable Mermaid support，且已安装Mermaid插件
中文乱码或样式异常的常见原因
不是字体问题，而是渲染引擎或编码配置偏差：
- 预览中中文显示方块或叠字：检查文件编码是否为
UTF-8（右下角状态栏看，点开可切换）；不要用 GBK 保存.md文件 - 表格错位、代码块高亮失效：原生插件默认用 Java 解析器，对 GFM 表格或语言注入支持弱；可尝试启用
Use CommonMark parser（在Settings → Languages & Frameworks → Markdown中勾选） - 公式渲染失败（如
$E=mc^2$）：原生插件不支持 KaTeX/MathJax；需换用Markdown Navigator或手动引入 JS 渲染
Mermaid 图表、目录树、自定义 CSS 这些进阶功能，原生插件基本靠不住——不是设置没找对，是它压根没实现。需要就装插件，别在设置里反复调参数白费时间。
