vscode notebook 单元格输出不渲染 html 或 markdown 的根本原因是内核未启用富文本支持或调用方式错误；python 单元格必须显式导入并调用 ipython.display.display()，仅 print 或裸对象无效，且需确保 ipython 已安装、内核正确配置。
为什么 VSCode Notebook 单元格输出不渲染 HTML 或 Markdown？
默认情况下，VSCode 的 .ipynb 文件中，即使你用 display(HTML(...)) 或 display(Markdown(...))，也可能只显示原始字符串或报错——根本原因是内核未启用富文本支持，或调用方式不匹配当前内核（如 Python 内核需 IPython.display，而纯 print() 或直接写字符串无效）。
- Python 单元格必须显式导入并调用
IPython.display下的函数，不能依赖repr自动转换 - JavaScript/Julia 等内核有各自机制，Python 是最常踩坑的场景
- VSCode 1.85+ 对富文本支持更稳定，旧版本可能跳过渲染直接输出字符串
Python Notebook 中正确显示 HTML 和 Markdown 的写法
关键不是“怎么写 HTML”，而是“怎么让内核识别并交由前端渲染”。以下写法在 VSCode 当前主流版本（1.84+）中可靠：
from IPython.display import HTML, Markdown, display
<h1>✅ 正确：display() 触发富文本协议</h1><p>display(HTML("</p><h2 style="color: blue">标题</h2><p>段落</p>"))<h1>✅ 正确：Markdown 渲染（支持 LaTeX）</h1><p>display(Markdown("<strong>加粗</strong> 和 $\int_0^1 x^2 dx$"))</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill1675" title="VSCode"><img
src="https://img.php.cn/upload/skill/000/000/081/178842972858328.jpg" alt="VSCode" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill1675" title="VSCode" class="overflowclass">VSCode</a>
<p class="overflowclass">避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。</p>
</div>
<a rel="nofollow" href="/xiazai/skill1675" title="VSCode" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h1>❌ 错误：仅 print 不触发渲染</h1><p>print(HTML("<b>不会加粗</b>")) # 输出 <ipython.core.display.html object></ipython.core.display.html></p><h1>❌ 错误：没调用 display()</h1><p>HTML("</p><div>被忽略</div>") # 单独一行，无输出或仅 repr
VSCode Notebook 富文本常见失效原因与修复
不是代码写错了，而是环境链路断了。重点排查这几点：
-
IPython未安装或版本过低（pip install -U ipython，建议 ≥8.12） - 内核切换错误：右上角选的是
Python 3.9，但实际启动的是 conda 环境里没装IPython的 kernel - 单元格执行后没看到输出？检查是否误点了「Clear All Outputs」或输出被折叠（点击右上角小三角展开）
- HTML 中含 JS 或 iframe？VSCode Notebook 默认禁用执行脚本，
<script></script>标签会被剥离，仅静态 HTML 生效 - 路径引用本地资源（如
<img src="./plot.png">）失败？VSCode Notebook 不提供 HTTP 服务，相对路径不工作，需用base64编码或转为绝对路径 +file://（不推荐，跨平台易挂）
替代方案：不用 display() 也能渲染 Markdown？
是的——但仅限纯 Markdown 文本，且必须用特定单元格类型：
- 将单元格类型从
Code切换为Markdown（按Esc→M），直接写## 标题、- 列表，保存即渲染 - 这种模式下不执行代码，也不支持变量插值（比如不能写
f"结果：{x}"） - 想动态生成 Markdown？仍需回到
Code单元格 +display(Markdown(...))，这是唯一可靠路径 - 注意：
Markdown单元格里写```python ... ```会高亮但不执行；要执行就得切回Code单元格
富文本真正卡点不在语法，而在「display 调用时机」和「内核上下文完整性」。哪怕一行 display(HTML("x")) 失效，也大概率是内核没加载 IPython.display 模块，而不是 HTML 写错了。
