文档站使用 KaTeX 在构建期渲染 LaTeX。
- 行内: 单美元
$E = mc^2$ → E=mc2
- 块级: 独占一行的双美元
$$ … $$
- 兜底:
<Math formula="..." /> 用于程序化或极密表达式
高斯积分 ∫−∞∞e−x2dx=π。
策略风险等级可记为 risk(c)∈{0,1,2,3,4,5}。
∇⋅E=ε0ρ,∇⋅B=0
H(X)=−x∑p(x)logp(x)=Ex∼p[−logp(x)]
(a11a21a12a22)(x1x2)=(b1b2)
decision(a)=⎩⎨⎧allowapprovedenyif risk(a)≤1if 2≤risk(a)≤3if risk(a)≥4
L(θ)=E(x,y)∼D[ℓ(fθ(x),y)]+λ∥θ∥22
何时 KaTeX 不够用▾
KaTeX 覆盖工程文档里绝大多数 AMS 数学,但不是完整 TeX(无任意宏包、有限 TikZ)。若遇到不支持的结构:简化表达式、改用 Mermaid/图,或离线预渲染 SVG 后用 <Frame> 嵌入。
默认不上全站 MathJax — 更重,且本站极少需要。
- 渲染:
apps/docs 内 KaTeX 管线(Starlight + rehype)
- 写作:
apps/docs/AUTHORING.md · 组件 <Math>
- 非运行时产品能力 — 仅文档