Math Equations

This is currently opt-in. To enable it, you need to install markdown-it-mathjax3 and set markdown.math to true in your config file:

npm add -D markdown-it-mathjax3

// .vitepress/config.ts
export default {
  markdown: {
    math: true
  }
}

Inline Equations

You can add inline math equations by wrapping them in single dollar signs $.

Input:

Albert Einstein's famous equation is $E = mc^2$, which explains the relationship between mass and energy.
Another inline example is the Pythagorean theorem $a^2 + b^2 = c^2$, which works perfectly within a sentence without breaking the layout.

Output:

Albert Einstein's famous equation is $E=m{c}^2$, which explains the relationship between mass and energy. Another inline example is the Pythagorean theorem $a^2+b^2=c^2$, which works perfectly within a sentence without breaking the layout.

Block Equations (Centered)

For equations that need to stand out or require more space, you can use block equations by wrapping them in double dollar signs $$. This will center them on their own line.

Input:

When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are:

$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$

Output:

When $a\ne 0$, there are two solutions to $(a{x}^2+bx+c=0)$ and they are:

$$x=\frac{-b\pm \sqrt{b^2-4ac}}{2a}$$

Large Equations (Scrollable)

If an equation is too long to fit on the screen, VitePress will automatically provide a horizontal scrollbar so it doesn't break the layout.

Input:

$$
\left( \sum_{k=1}^n a_k b_k \right)^2 \le \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right) \quad \text{where } a_i, b_i \in \mathbb{R} \text{ for } i = 1, \dots, n \text{ and } \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} \text{ and } \lim_{x \to \infty} \left(1 + \frac{1}{x}\right)^x = e
$$

Output:

$${\left(\sum _{k=1}^n{a}_k{b}_k\right)}^2\le \left(\sum _{k=1}^n{a}_k^2\right)\left(\sum _{k=1}^n{b}_k^2\right)\text{where }{a}_i,b_i\in \mathbb{R}\text{ for }i=1,\dots ,n\text{ and }{\int }_{-\mathrm{\infty }}^{\mathrm{\infty }}{e}^{-x^2}dx=\sqrt{\pi }\text{ and }\underset{x\to \mathrm{\infty }}{lim}{(1+\frac{1}{x})}^x=e$$

Equations in Tables

You can even place equations inside Markdown tables:

Input:

| equation                                                                                                                                                                     | description                                                                            |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| $\nabla \cdot \vec{\mathbf{B}}  = 0$                                                                                                                                         | divergence of $\vec{\mathbf{B}}$ is zero                                               |
| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t}  = \vec{\mathbf{0}}$                                                             | curl of $\vec{\mathbf{E}}$ is proportional to the rate of change of $\vec{\mathbf{B}}$ |
| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}} \quad \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | Maxwell's equations                                                                    |

Output:

equation	description
$\mathrm{\nabla }\cdot \overrightarrow{\mathbf{B}}=0$	divergence of $\overrightarrow{\mathbf{B}}$ is zero
$\mathrm{\nabla }\times \overrightarrow{\mathbf{E}}+\frac{1}{c}\frac{\partial \overrightarrow{\mathbf{B}}}{\partial t}=\overrightarrow{\mathbf{0}}$	curl of $\overrightarrow{\mathbf{E}}$ is proportional to the rate of change of $\overrightarrow{\mathbf{B}}$
$\mathrm{\nabla }\times \overrightarrow{\mathbf{B}}-\frac{1}{c}\frac{\partial \overrightarrow{\mathbf{E}}}{\partial t}=\frac{4\pi }{c}\overrightarrow{\mathbf{j}}\mathrm{\nabla }\cdot \overrightarrow{\mathbf{E}}=4\pi \rho$	Maxwell's equations