DataSpell无法正常渲染Jupyter Notebook中Markdown单元格的LaTeX公式

修复步骤 #

• 检查Jupyter Markdown渲染开关
  打开File > Settings > Languages & Frameworks > Jupyter，确认Render Markdown in preview选项处于勾选状态，DataSpell默认会对部分项目禁用该配置，和PyCharm的默认配置逻辑不同
• 检查Markdown公式支持开关
  打开File > Settings > Editor > Markdown，在Markdown Extensions区域找到LaTeX formula选项，确认处于勾选状态，该开关是控制所有Markdown场景下公式渲染的核心配置，部分DataSpell版本默认未勾选
• 禁用冲突插件
  TeXiFy插件面向独立.tex文件设计，不会处理Notebook内的Markdown公式，反而可能和内置Jupyter渲染逻辑冲突，先禁用TeXiFy后重启DataSpell测试
• 重置Jupyter渲染配置
  打开出问题的Notebook，在顶部编辑器工具栏找到Jupyter相关设置按钮，选择Reset Renderer Settings，重新运行Markdown单元格（按Shift+Enter）即可
• 调整公式语法适配
  DataSpell内置的MathJax版本低于PyCharm默认版本，对部分新LaTeX语法支持度不足，将公式分隔符统一替换为标准的$（行内公式）和$$（块级公式），避免使用\(、\[类分隔符，可先测试基础公式如$$E=mc^2$$是否可以正常渲染
• 清除缓存重启
  以上步骤均无效时，关闭DataSpell，删除对应版本的本地缓存目录后重启即可：
  Windows：C:\Users\<你的用户名>\.DataSpell<版本号>\system
  macOS：~/Library/Caches/JetBrains/DataSpell<版本号>
  Linux：~/.cache/JetBrains/DataSpell<版本号>

效果参考 #

异常显示效果 #

预期正常效果 #

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