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 的第三方插件，它们会劫持预览逻辑，导致面板空白或崩溃

唤出并切换到正确的预览面板

内置预览默认不自动弹出，必须手动触发：

Markdown Converter 1.0.0

使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。

下载

• 快捷键：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 运行时会导致预览区一片空白，连标题都不显示。解决方法：

• 进入 Settings → Languages & Frameworks → Markdown
• 找到 Preview rendering engine 选项
• 从 chromiumbrowser 改为 Compose (experimental)
• 保存后重新打开预览面板，通常立刻恢复渲染

这个坑特别隐蔽：插件开着、菜单正常、快捷键响应，但预览区就是空的——问题不在配置，而在引擎本身对运行时的依赖。别花时间查日志或重装插件，先切引擎。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！