pycharm默认支持markdown实时预览，打开.md文件后点击右上角preview或split按钮即可启用；若按钮缺失，需在settings→语言与框架→markdown中设置预览布局；预览不更新常见原因包括未保存、同步滚动被禁用或路径含中文；代码块高亮错乱可关闭语言注入；mermaid需安装官方插件并严格使用`mermaid语法。
PyCharm 默认就支持 Markdown 实时预览，不需要额外安装插件——只要文件名是 readme.md 或匹配 *.md 模式，开箱即用。
怎么打开预览窗格？
打开任意 .md 文件后，编辑器右上角会出现两个按钮：Editor 和 Preview。点击 Preview 就能单独查看渲染效果；更常用的是点 Split（拆分），让左侧写源码、右侧实时看 HTML 渲染结果。
如果没看到这些按钮，说明预览功能被关掉了。按 Ctrl Alt 0 S 进设置 → 语言与框架 | Markdown → 在 预览布局 下选 左右拆分 或 上下拆分，保存即可恢复。
为什么改了内容预览不更新？
常见原因有三个：
- 文件未保存：PyCharm 的预览默认只响应已保存的变更，
Ctrl S一下再看 - 同步滚动被禁用：虽然不影响渲染，但容易误以为“没动”，检查设置里是否勾选了
sync scroll in the editor and preview - 文件不在项目根目录下，且路径含中文或特殊字符：某些版本对非 ASCII 路径解析不稳定，建议移到英文路径下测试
代码块里语法高亮错乱或报红怎么办？
PyCharm 默认会对 ```python 这类带语言标识的代码块做语言注入，启用 Python 补全和检查。但如果你只是贴一段伪代码或命令行示例，它反而会报错。
解决方法是关掉自动注入：
- 进
Ctrl Alt 0 S→语言与框架 | Markdown - 取消勾选
在代码块中注入语言和在代码块中显示问题 - 这样
```bash、```text就不会被当成真实脚本校验了
Mermaid 图表不渲染？别急着装插件
PyCharm 原生不支持 Mermaid，必须装插件才能渲染。但注意两点：
- 官方插件市场里的
Mermaid插件（JetBrains 官方维护）装完重启就能用，不用配 CLI 工具 - 如果用了第三方插件如
Markdown Navigator Enhanced，它可能和内置 Markdown 支持冲突，导致预览失效——优先用官方 Mermaid 插件 - Mermaid 代码块必须严格写成
```mermaid（小写、无空格），否则识别失败
真正容易被忽略的是：Mermaid 渲染依赖预览窗格开启，且文件必须以 .md 结尾——.markdown 在某些旧版插件里可能不触发渲染。
