数学公式示例

本站启用了 VitePress 内置的数学公式支持，底层是 markdown-it-mathjax3：构建时用 MathJax 把 LaTeX 预渲染成内联 SVG，因此不需要额外的客户端脚本或字体（本站只额外加了一点让长公式横向滚动的样式）。

配置位于 docs/.vitepress/config.mts 的 markdown.math。

行内公式

用单个 $ 包裹：质能方程 $E=m{c}^2$，欧拉恒等式 $e^{i\pi }+1=0$，以及 $\frac{\partial f}{\partial x}$。

块级公式

用 $$ 包裹并独占一行，会自动居中：

$${\int }_{-\mathrm{\infty }}^{\mathrm{\infty }}{e}^{-x^2}\mathrm{d}x=\sqrt{\pi }$$

多行对齐

$$\begin{array}{rl}\mathrm{\nabla }\cdot \mathbf{E}& =\frac{\rho }{{\epsilon }_0}\\ \mathrm{\nabla }\cdot \mathbf{B}& =0\\ \mathrm{\nabla }\times \mathbf{E}& =-\frac{\partial \mathbf{B}}{\partial t}\\ \mathrm{\nabla }\times \mathbf{B}& ={\mu }_0\mathbf{J}+{\mu }_0{\epsilon }_0\frac{\partial \mathbf{E}}{\partial t}\end{array}$$

矩阵与分段函数

$$\mathbf{A}=\left(\begin{array}{ccc}{a}_{11}& a_{12}& a_{13}\\ a_{21}& a_{22}& a_{23}\\ a_{31}& a_{32}& a_{33}\end{array}\right)f(x)=\{\begin{array}{ll}{x}^2,& x\ge 0\\ -x^2,& x<0\end{array}$$

注意事项

• 美元符号冲突：正文里想显示字面量美元符号时要转义，写成 \$。
• 代码块里的公式不会被渲染，$...$ 会原样保留，方便写示例。
• 公式在构建期渲染成 SVG，所以 docs:dev 和 docs:build 的结果一致，也不会出现刷新闪烁（FOUC）。
• 长公式在窄屏下自动横向滚动，见 docs/.vitepress/theme/custom.css。
• 插件默认加载 MathJax 的整套 TeX 宏包（AllPackages），ams、mathtools、mhchem、cancel 等开箱可用。若要传入自定义参数，把 math: true 换成选项对象即可，例如 math: { svg: { fontCache: 'global' } }。