修改PyCharm中Jupyter Notebook的Markdown预览样式

我之前也踩过这个坑——PyCharm里普通Markdown的CSS改完立刻生效，但Jupyter Notebook里的Markdown预览就是纹丝不动，核心原因是Jupyter的Markdown渲染有独立的DOM结构和样式优先级，普通全局CSS规则根本碰不到它。下面是我亲测有效的几个解决思路：

1. 针对Jupyter专属CSS选择器写规则 #

Jupyter在PyCharm里渲染Markdown时，所有内容都会被包裹在特定类名的容器里，比如.jp-MarkdownOutput或者.rendered_html（不同PyCharm版本可能略有差异）。你需要把CSS规则精准绑定到这些选择器上，举个实用的例子：

/* 调整Jupyter Markdown正文的行距、字体大小和文字颜色 */
.jp-MarkdownOutput p {
    line-height: 1.8;
    font-size: 16px;
    color: #333333;
}

/* 自定义一级标题样式 */
.jp-MarkdownOutput h1 {
    color: #2c3e50;
    font-size: 28px;
    margin-bottom: 15px;
}

怎么找这些专属选择器？很简单：在Jupyter的Markdown预览区域右键，选择Inspect（PyCharm自带的元素检查工具），就能看到当前元素的类名和层级结构，照着写规则就行。

2. 解决样式优先级冲突 #

如果写了专属选择器还是不生效，大概率是PyCharm自带的Jupyter样式优先级比你的自定义规则高。这时候可以用两个办法：

• 把选择器写得更具体，比如加上父容器的类：.jp-Cell .jp-MarkdownOutput p
• 临时用!important强制覆盖（不推荐长期使用，但能快速验证规则是否有效）：

.jp-MarkdownOutput p {
    line-height: 1.8 !important;
}

3. 清理PyCharm缓存并重启 #

有时候PyCharm会缓存旧的CSS样式，导致新规则不加载。试试这个操作：

• 点击顶部菜单的 File -> Invalidate Caches...
• 勾选"Clear file system cache and local history"，然后点击"Invalidate and Restart"
  重启后再打开Jupyter Notebook，新的CSS应该就能生效了。

4. 备选：直接修改PyCharm内置的Jupyter CSS文件（不推荐） #

如果上面的方法都不行，可以直接去修改PyCharm安装目录里的Jupyter样式文件，但注意PyCharm更新后会被覆盖，所以仅作为最后手段：

• 找到PyCharm的安装路径，比如Windows下是C:\Program Files\JetBrains\PyCharm <版本号>\plugins\python\jupyter\css
• 修改里面的markdown.css或者rendered_html.css文件，添加你的自定义规则
• 重启PyCharm生效

内容的提问来源于stack exchange，提问作者Dervin Thunk