WebStorm默认不双击打开浏览器预览Markdown,而是启用内置Markdown Preview面板;需通过快捷键Ctrl+Shift+P(或Cmd+Shift+P)调出,或右键选择Open Preview,确保Markdown插件已启用。
WebStorm里双击打不开Markdown预览?先确认这个设置
默认情况下,WebStorm不会用内置浏览器直接打开
文件预览——它会用编辑器内嵌的渲染面板(Markdown Preview)显示,而不是新标签页或系统浏览器。如果你双击文件只看到源码,说明预览面板没激活,或者被关掉了。
按
(Windows/Linux)或
(macOS),输入
,选中并执行,就能在右侧/底部唤出实时渲染面板
也可以右键文件 →
(注意不是
)
如果菜单里没有
,说明插件未启用:进入
,确保
插件已勾选并重启
想用 Chrome/Firefox 实时刷新预览?别用 Open in Browser
是把原始
文件丢给浏览器——而浏览器不解析 Markdown,只会下载或显示乱码。真要浏览器预览,得靠 Live Preview 服务或导出 HTML。
推荐做法:安装
插件(比原生插件更稳定),它提供
功能,会自动转换并启动本地服务,支持保存即刷新
手动导出:右键文件 →
,再用浏览器打开生成的
文件(但不支持热更新)
命令行替代方案:用
或
起个 watch 服务,配合 WebStorm 的
配置一键触发
预览样式丑、不支持 Mermaid/GFM 表格?检查渲染引擎和配置
WebStorm 原生 Markdown 插件默认用 Java 实现的解析器,对 Mermaid、数学公式、GitHub 风格表格等支持有限,且样式固定无法自定义。
进
,把
改成
(比默认的
兼容性更好)
勾选
和
(后者需额外安装 Mermaid CLI 并配置路径)
自定义 CSS:在同目录放
,然后在设置里指定该文件路径,可覆盖默认字体、代码块背景等
为什么改了内容预览不更新?留意文件编码和换行符
常见静默失败原因不是功能坏了,而是文件本身有隐藏陷阱。
确保文件编码是
(右下角状态栏查看,点开可切换),含中文或 emoji 时编码错会导致预览空白
混合使用
和
可能让某些扩展语法(如任务列表
)失效,统一为
(
)
如果用了 Front Matter(YAML 头部),确认开头是
单独成行,且 WebStorm 设置中启用了
WebStorm 的 Markdown 预览不是“开箱即用”的浏览器体验,它的强项在于编辑与渲染联动,但所有依赖项(插件、引擎、路径、编码)都得对齐才真正可用。最容易被跳过的其实是 Flexmark 渲染器切换和 Mermaid CLI 的路径配置——这两步不做,再多的快捷键也救不了流程图渲染。
.mdCtrl+Shift+PCmd+Shift+PMarkdown PreviewOpen PreviewOpen in BrowserOpen PreviewSettings → PluginsMarkdownOpen in Browser.mdMarkdown NavigatorPreview in BrowserExport to HTML.htmlmarkedmarkdown-it-cliExternal ToolsSettings → Languages & Frameworks → MarkdownRendererFlexmarkCommonMarkEnable extended syntaxEnable Mermaid supportmarkdown.cssUTF-8\r\n\n- [x]LFFile → Line Separators → Unix and macOS (\n)---Process YAML front matter