PyCharm 默认不支持 Markdown，需手动安装官方 Markdown 插件并重启，再绑定 *.md 文件类型；启用代码块语言注入、粘贴图片及 Mermaid 渲染需分别安装对应插件。
PyCharm 默认不带 Markdown 支持，必须手动安装插件才能正确识别 README.md、高亮语法、启用预览和命令运行等功能。不装插件的话，.md 文件就只是纯文本，连分屏预览都没有。
找不到 Markdown 插件？先确认 PyCharm 版本和插件源
PyCharm 2023.2+ 的插件市场界面改了，“Install JetBrains plugin”按钮已移除。别在旧教程里找这个入口。
- 打开
File → Settings（Windows/Linux）或PyCharm → Preferences（macOS） - 左侧选
Plugins，确保顶部是Marketplace标签页（不是Installed或Settings） - 搜索框直接输
Markdown，会出现两个关键插件：Markdown（JetBrains 官方，必装）和Markdown Navigator（第三方增强，可选但推荐） - 如果搜不到，检查是否误进了
Settings → Plugins → Settings里的“Plugin Repositories”——那里默认只勾了官方源；若手动添加过非官方源，可能干扰搜索，建议清空后重试
安装完没反应？重启 + 文件类型绑定是关键
装完不生效，90% 是因为没重启，或 .md 后缀没被识别为 Markdown 类型。
- 安装后必须重启 PyCharm，否则
Settings → Editor → File Types里看不到Markdown条目 - 重启后进
Settings → Editor → File Types，在Recognized File Types列表里找到Markdown - 检查右侧
Registered Patterns是否已有*.md和*.markdown；没有就点+手动加，格式必须严格写成*.md（不能写成README.md或漏掉星号） - 如果之前用记事本改过文件名导致扩展名损坏（比如存成
readme.md.txt），PyCharm 会按真实后缀判断，此时需重命名并确保系统隐藏扩展名开关已关闭
预览不显示、代码块不高亮？检查语言注入设置
分屏预览空白、```python 里没语法高亮，大概率是语言注入被关了或冲突了。
- 进
Settings → Languages & Frameworks → Markdown - 确认勾选了
Inject language in code blocks（默认开启，但有人为禁用过） - 如果同时装了
Markdown Navigator和官方Markdown插件，二者在旧版本 PyCharm 中可能冲突，导致预览失效；建议优先用官方插件，再单独装Paste images into Markdown这类轻量增强插件 - 代码块里想禁用校验（比如写伪代码），可取消勾选
Show problems in code blocks，避免红色波浪线干扰
粘贴图片失败、Mermaid 图表不渲染？这些功能要额外开
官方 Markdown 插件默认不支持图片粘贴和 Mermaid 渲染，得装配套插件。
- 图片粘贴：装
Paste images into Markdown（插件 ID8446），在线安装失败就去plugins.jetbrains.com下载.zip离线安装，路径选对、重启即可 - Mermaid 图表：单独装
Mermaid插件（JetBrains 官方出品），装完不用额外配置，```mermaid块就能实时渲染 - PlantUML 需要额外装 Java 和 PlantUML JAR，且 PyCharm 设置里要指定路径，复杂度高，一般场景不建议折腾
最容易被忽略的其实是文件后缀绑定和重启这两步——很多人装完立刻去新建 .md 文件，发现还是白板，其实只是 PyCharm 没把后缀和插件关联上。另外，Vim 插件开着时会劫持快捷键，导致预览窗格切换失灵，必要时关掉 Tools → Vim Emulator。
