You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

GitHub README添加MathJax后图片无法渲染的问题求助

GitHub README图片与MathJax公式冲突的原因

核心冲突点

GitHub的Markdown渲染引擎对图片语法和MathJax块级公式的解析逻辑存在优先级与上下文隔离的问题:

  • MathJax的块级公式($$...$$)必须单独占一行,且前后要有空白行分隔,否则渲染引擎会把图片结尾的语法和公式开头的$$归为同一解析上下文,直接破坏图片链接的识别。
  • 你用的<br>标签虽然能强制换行,但GitHub的渲染器对HTML标签和Markdown原生语法的混合解析规则不兼容,<br>没法彻底隔开图片和公式的解析环境,反而让渲染器误判了内容结构。

具体解析过程

看你提供的代码片段:

<br> We plot the results:  
![My Image](./demo_figure.png)  
<br>Some more text.. $$x+y=2$$

图片行之后的<br>Some more text.. $$x+y=2$$没有给公式留独立的空白行,渲染引擎会把图片闭合后的后续内容(包括<br>和公式)当成图片的附属部分,导致图片链接被错误解析,自然加载不出来。一旦删掉MathJax公式,图片所在行的解析上下文恢复正常,就能正确渲染了。

内容的提问来源于stack exchange,提问作者reloh100

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.10 20:04:53