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 类型。
将 Markdown 格式的回复转换为适合 Telegram 的富文本,避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。
- 安装后必须重启 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。










