PhpStorm打开.md文件只显示源码，是因为误用Open in Browser（浏览器不解析Markdown），正确做法是启用Markdown插件后通过Ctrl+Shift+P唤出Markdown Preview面板，或右键选Open Preview；若预览空白，需将渲染引擎从chromiumbrowser改为Compose(experimental)。
PhpStorm 打开 .md 文件只显示源码、不渲染预览？不是插件没装，而是你点错了菜单，或者渲染引擎卡在 Chromium 上出错。
为什么 Open in Browser 不是预览，而是“放弃治疗”
浏览器根本不会解析 .md 文件——Open in Browser 只是把原始文本扔给 Chrome/Firefox，结果通常是：下载文件、显示一堆 # 和 ```、图片路径全 404、Mermaid 图表和数学公式完全消失。这不是 PhpStorm 的 bug，是浏览器的限制。真要浏览器里看，必须走导出或本地服务路径，而不是双击或右键选错项。
确认 Markdown 插件已启用且生效
- 打开
Settings → Plugins（Windows/Linux 快捷键Ctrl+Alt+S，macOS 是Cmd+,） - 搜索
Markdown，确保状态是勾选，且不是灰色或写着Disabled - 如果刚启用，必须重启 PhpStorm —— 不重启，
Open Preview菜单项不会出现，快捷键也无效 - 禁用所有名字含
Markdown Preview、MD Live、Markdown Navigator的第三方插件，它们会劫持预览逻辑，导致面板空白或崩溃
唤出并切换到正确的预览面板
内置预览默认不自动弹出，必须手动触发：
- 快捷键：
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Markdown Preview回车 - 右键
.md文件 → 选Open Preview（⚠️不是Open in Browser） - 面板弹出后，点击右上角
Editor/Preview切换单/双栏；点分屏图标可切Vertical或Horizontal布局 - 拖动分隔线调节大小，缩放字体用
Ctrl+Mouse Wheel（macOS 同理）
PyCharm/PhpStorm 预览空白？试试切换渲染引擎
部分版本（尤其是较新 EAP 或 2026.1+）默认用 chromiumbrowser 渲染引擎，但本地环境缺失 Chromium 运行时会导致预览区一片空白，连标题都不显示。解决方法：
立即学习“PHP免费学习笔记（深入）”；
- 进入
Settings → Languages & Frameworks → Markdown - 找到
Preview rendering engine选项 - 从
chromiumbrowser改为Compose (experimental) - 保存后重新打开预览面板，通常立刻恢复渲染
这个坑特别隐蔽：插件开着、菜单正常、快捷键响应，但预览区就是空的——问题不在配置，而在引擎本身对运行时的依赖。别花时间查日志或重装插件，先切引擎。
