Skip to content

修复多处行内公式渲染错误 - #45

Open
LiuMengxuan04 wants to merge 1 commit into
caomaolufei:mainfrom
LiuMengxuan04:fix/math-formula-rendering
Open

修复多处行内公式渲染错误#45
LiuMengxuan04 wants to merge 1 commit into
caomaolufei:mainfrom
LiuMengxuan04:fix/math-formula-rendering

Conversation

@LiuMengxuan04

@LiuMengxuan04 LiuMengxuan04 commented Sep 6, 2026

Copy link
Copy Markdown

问题说明

部分 Markdown 行内公式的结束定界符被误写为 \$。反斜杠会将美元符号转义为普通字符,导致 remark-math 无法识别公式的结束位置,最终在页面上直接显示红色的 LaTeX 源码。

集合通信页面

集合通信页面中的公式渲染错误

Self-Attention 参数量页面

Self-Attention 参数量页面中的公式渲染错误

仓库中共有 5 处相同问题,分别位于:

  • Self-Attention 文档:MHA 参数量公式;
  • Self-Attention 文档:总 HBM 访问量;
  • CUDA GEMM 文档:线程级 Tile 尺寸;
  • 集合通信文档:延迟项;
  • 集合通信文档:带宽项。

修改内容

  • 将错误的结束定界符 \$ 修正为 $
  • 将加粗文字和数学公式拆开书写,例如从 **延迟项 $\alpha\$** 调整为 **延迟项** $\alpha$
  • 保留公式内部必要的 LaTeX 命令,例如 \times\frac\text
  • 未修改公式含义及文档内容。

修复效果

以下公式现在均可由 KaTeX 正常渲染:

  • 4 \times d_{model}^2
  • O(N^2)
  • TM = TN = 8
  • \alpha
  • \frac{\text{数据量}}{B}

验证

  • 扫描全部 Markdown/MDX 文档,不再存在同类 \$ 错误;
  • 执行 git diff --check,检查通过;
  • 执行 npm run build,Astro 检查为 0 errors;
  • 成功生成 349 个静态页面;
  • 检查构建后的 HTML,上述公式均已生成 span.katex 节点,且没有 katex-error

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant