phpstorm怎么配置Markdown实时预览插件（文档编写）-phpstorm-PHP中文网

phpstorm 自带 markdown 实时预览功能，无需额外插件；需确认 markdown 插件已启用（settings → plugins 中勾选），文件后缀为 .md 或 .markdown，再通过 ctrl+shift+p（win/linux）或 cmd+shift+p（macos）唤出预览面板，禁用第三方冲突插件，并避免使用 open in browser（浏览器无法原生解析 markdown）。

phpstorm怎么配置markdown实时预览插件（文档编写）

PhpStorm 自带 Markdown 实时预览功能，不需要额外安装插件——只要 Markdown 插件启用、文件后缀是 .md 或 .markdown，就能开箱即用。强行装第三方“预览插件”反而容易冲突或失效。

怎么确认 Markdown 插件已启用

很多人预览不出现，根本原因是插件被禁用了：

打开 Settings（Windows/Linux：Ctrl+Alt+S；macOS：Cmd+,）→ Plugins
搜索 Markdown，确保它处于勾选状态（不是灰色、不是“Disabled”）
如果刚启用，需重启 PhpStorm 才生效
禁用其他名字含 “Markdown Preview” “MD Live” 的第三方插件，它们常与内置功能打架

怎么打开并调整实时预览面板

预览默认不自动弹出，得手动唤起，且布局可自由切换：

OCR 文档识别转 Markdown（WiseOCR）

WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi

下载

快捷键触发：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 同理）

为什么 Open in Browser 不渲染 Markdown

浏览器无法原生解析 .md 文件，直接打开只会看到源码或触发下载：

Open in Browser 是把原始文本丢给 Chrome/Firefox，不经过任何转换
所有扩展语法（如 Mermaid 图表、数学公式、表格对齐）完全失效
链接跳转、本地图片路径、项目内文件引用也全部断掉
真要浏览器里看，必须走导出路径：右键 → Export to HTML → 用浏览器打开生成的 .html 文件（但改源码后需重新导出，无热更新）

怎么让预览更贴合文档写作需求

内置预览支持定制，关键设置集中在 Settings → Languages & Frameworks → Markdown：

Default layout 设为 Editor and Preview，避免每次都要手动唤出
Preview layout 选 Horizontal 更适合笔记本或竖屏写作场景
勾选 Sync scroll in the editor and preview，编辑时预览自动定位到对应段落
若代码块只是示例（非可运行代码），关闭 Inject languages in code fences 和 Show problems in code fences，避免误报语法错误
想改样式？点 Custom CSS → Load from 指向一个本地 markdown.css，比如调大字体、加行高、改背景色