TeX

Let the Markdown file in your VuePress site support the $TEX$ syntax.

Config

// .vuepress/config.ts
import { mdEnhancePlugin } from "vuepress-plugin-md-enhance";

export default {
  plugins: [
    mdEnhancePlugin({
      // Enable Tex Support using katex
      katex: true,
      // Enable Tex Support using mathjax
      mathjax: true,
    }),
  ],
};

// .vuepress/config.js
import { mdEnhancePlugin } from "vuepress-plugin-md-enhance";

export default {
  plugins: [
    mdEnhancePlugin({
      // Enable Tex Support using katex
      katex: true,
      // Enable Tex Support using mathjax
      mathjax: true,
    }),
  ],
};

You can only enable ONE of them, and katex has a higher priority.

Grammar

Inline Syntax

Use $tex expression$.

Euler’s identity $e^{i\pi}+1=0$ is a beautiful formula in $\mathbb{R}^2$.

Euler’s identity $e^{i\pi }+1=0$ is a beautiful formula in ${\mathbb{R}}^2$.

Block Syntax

Use $$tex expression$$.

$$
\frac {\partial^r} {\partial \omega^r} \left(\frac {y^{\omega}} {\omega}\right)
= \left(\frac {y^{\omega}} {\omega}\right) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^ Ir \cdots (r-i+1) (\log y)^{ri}} {\omega^i} \right\}
$$

$$\frac{{\partial }^r}{\partial {\omega }^r}\left(\frac{y^{\omega }}{\omega }\right)=\left(\frac{y^{\omega }}{\omega }\right)\{(\log y{)}^r+\sum _{i=1}^r\frac{(-1{)}^{I}r\cdots (r-i+1)(\log y{)}^{ri}}{{\omega }^i}\}$$

Playground

Input

\frac {\partial^r} {\partial \omega^r} \left(\frac {y^{\omega}} {\omega}\right) = \left(\frac {y^{\omega}} {\omega}\right) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^ Ir \cdots (r-i+1) (\log y)^{ri}} {\omega^i} \right\}

Output

$$\frac {\partial^r} {\partial \omega^r} \left(\frac {y^{\omega}} {\omega}\right) = \left(\frac {y^{\omega}} {\omega}\right) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^ Ir \cdots (r-i+1) (\log y)^{ri}} {\omega^i} \right\}$$

Support List

Katex:

• KaTeX Support Features
• KaTeX Support List

Mathjax:

• Supported TeX/LaTeX commands

Advanced

KaTeX

When using KaTeX, you can pass an object to katex as KatexOptions. It will be passed to KaTeX. Please see KaTeX Docs for available options.

Also, a special option mhchem is supported for you to enable mhchem extension by setting it to true.

Mathjax

When using mathjax, you can pass an object to mathjax.

You can set output option to either svg (default) or chtml to change between SVG and HTML output.

Also, you can set tex option which is passed to TeX input parser, and you can set chtml or svg option based on your output syntax which is passed to Common HTML output parser and SVG output parser.

Tex Tutorial

Operator

• Some operators can be entered directly in math mode; others need to be generated using control sequences:

  • +: $+$
  • -: $-$
  • \times: $\times$
  • \ div: $÷$
  • =: $=$
  • \pm: $\pm$
  • \cdot: $\cdot$
  • \cup: $\cup$
  • \geq: $\ge$
  • \leq: $\le$
  • \neq: $\ne$
  • \approx: $\approx$
  • \equiv: $\equiv$
  • \quad: $$ (blank separator)

• Radical: \sqrt{xxx} $\sqrt{xxx}$

• Fraction \frac{aaa}{bbb} $\frac{aaa}{bbb}$ (the first parameter is the numerator and the second is the denominator).

• Sum: \sum $\sum$

• Tandem: \prod $\prod$

• Limit: \lim $lim$

• Points: \int $\int$

• Multiple points:

  • \iint: $\iint$
  • \iiint: $\iiint$
  • \iiiint: $⨌$
  • \idotsint $\int \cdots \int$

Tips

Large operators such as continuous addition, multiplication, limits, and integrals can use \limits and \nolimits to force explicitly specify compress these superscripts or not.

\varoiint, \sqint, \sqiint, \ointctrclockwise, \ointclockwise, \varointclockwise, \varointctrclockwise, \fint, \landupint, \landdownint are not supported currently.

Case

$\sqrt{x}$, $\frac{1}{2}$.

$\sum _{i=1}^{n}i\prod _{i=1}^n$

$\sum _{i=1}^{n}i\prod _{i=1}^n$

${\iint }_1^2{x}^2{\iiint }_1^2{x}^2{⨌}_1^2{x}^2\int \cdots {\int }_1^2{x}^2$

$\underset{1}{\overset{2}{\iint }}{x}^2\underset{1}{\overset{2}{\iiint }}{x}^2\underset{1}{\overset{2}{⨌}}{x}^2\underset{1}{\overset{2}{\int \cdots \int }}{x}^2$

$${\iint }_1^2{x}^2{\iiint }_1^2{x}^2{⨌}_1^2{x}^2\int \cdots {\int }_1^2{x}^2$$

$\sqrt{x}$, $\frac{1}{2}$.

$\sum_{i=1}^n i\; \prod_{i=1}^n$

$\sum\limits _{i=1}^n i\; \prod\limits _{i=1}^n$

$\iint_1^2 x^2\; \iiint_1^2 x^2\; \iiiint_1^2 x^2\; \idotsint_1^2 x^2$

$\iint\limits_1^2 x^2\; \iiint\limits_1^2 x^2\; \iiiint\limits_1^2 x^2\; \idotsint\limits_1^2 x^2$

$$\iint_1^2 x^2\; \iiint_1^2 x^2\; \iiiint_1^2 x^2\; \idotsint_1^2 x^2$$

Symbol

• English letters can be entered directly

  $abcxyzABC$

  $a \quad b \quad c \quad x \quad y \quad z \quad A \quad B \quad C$
  

• Greek characters use \characterName to enter symbols, and output capital letters when the first letter is capitalized.

  $\alpha \beta \gamma \mathrm{\Omega }\mathrm{\Delta }\mathrm{\Gamma }$

  $\alpha \quad \beta \quad \gamma \quad \Omega \quad \Delta \quad \Gamma$
  

• Other mathematical expressions can be used correspondingly

  ${\log }_{a}b\partial x$

  $\log_{a}{b} \quad \partial x$
  

Superscript and Subscript

• Superscript, use ^ to achieve
• Subscript, use _ to achieve
• By default, superscript and subscript only apply to the next character. To work with multiple consecutive characters, please enclose these characters in curly brackets {}.

Demo

Einstein ’s $E=m{c}^2$.

$2^{10}>1000$

Einstein ’s $E=mc^2$.

$2^{10} > 1000$

Delimiters (parentheses, etc.)

Various parentheses are represented by commands such as (), [], \{\}, \langle\rangle.

Tips

Note that curly braces are usually used to enter command and environment parameters, so they must be preceded by \ in mathematical formulas.

Because the application of | and \| in LaTeX is too casual, we recommend using \lvert\rvert and \ lVert\rVert instead.

To adjust the size of these delimiters, we recommend using \big, \Big, \bigg, \Bigg and a series of commands to adjust the size before the above brackets.

$(((((x)))))$$[[[[[x]]]]]$$\{\{\{\{\{x\}\}\}\}\}$$⟨⟨⟨⟨⟨x⟩⟩⟩⟩⟩$$|||||x|||||$$\Vert \Vert \Vert \Vert \Vert x\Vert \Vert \Vert \Vert \Vert$

$\Biggl(\biggl(\Bigl(\bigl((x)\bigr)\Bigr)\biggr)\Biggr)$
$\Biggl[\biggl[\Bigl[\bigl[[x]\bigr]\Bigr]\biggr]\Biggr]$
$\Biggl \{\biggl \{\Bigl \{\bigl \{\{x\}\bigr \}\Bigr \}\biggr \}\Biggr\}$
$\Biggl\langle\biggl\langle\Bigl\langle\bigl\langle\langle x
\rangle\bigr\rangle\Bigr\rangle\biggr\rangle\Biggr\rangle$
$\Biggl\lvert\biggl\lvert\Bigl\lvert\bigl\lvert\lvert x
\rvert\bigr\rvert\Bigr\rvert\biggr\rvert\Biggr\rvert$
$\Biggl\lVert\biggl\lVert\Bigl\lVert\bigl\lVert\lVert x
\rVert\bigr\rVert\Bigr\rVert\biggr\rVert\Biggr\rVert$

Ellipsis

The ellipsis is represented by commands such as \dots,\cdots, \vdots,\ddots.

Tips

\dots and\cdots have different vertical positions. The former is generally used for subscripted sequences.

$x_1,x_2,\dots ,x_{n}1,2,\cdots ,n⋮\ddots$

$x_1,x_2,\dots ,x_n \quad 1,2,\cdots ,n \quad \vdots\quad \ddots$

Matrix

pmatrix, bmatrix, Bmatrix, vmatrix, Vmatrix and other environments can add various separators on both sides of the matrix.

$$\left(\begin{array}{cc}a& b\\ c& d\end{array}\right)\left[\begin{array}{cc}a& b\\ c& d\end{array}\right]\left\{\begin{array}{cc}a& b\\ c& d\end{array}\right\}\left|\begin{array}{cc}a& b\\ c& d\end{array}\right|\Vert \begin{array}{cc}a& b\\ c& d\end{array}\Vert$$

$$
\begin{pmatrix} a&b\\c&d \end{pmatrix} \quad
\begin{bmatrix} a&b\\c&d \end{bmatrix} \quad
\begin{Bmatrix} a&b\\c&d \end{Bmatrix} \quad
\begin{vmatrix} a&b\\c&d \end{vmatrix} \quad
\begin{Vmatrix} a&b\\c&d \end{Vmatrix}
$$

Using the smallmatrix environment, you can generate small matrices of inline formulas.

A small matrix: $(\begin{array}{cc}a& b\\ c& d\end{array})$.

A small matrix: $( \begin{smallmatrix} a&b\\c&d \end{smallmatrix} )$.

Multi-line Formula

• newline

  Use \\ or \newline to wrap

  $$\begin{gathered} x=a+b+c+ \\ d+e+f+g \end{gathered}$$$$\begin{gathered} x=a+b+c+ \\ d+e+f+g \end{gathered}$$

  $$
  x = a+b+c+ \\
  d+e+f+g
  $$
  
  $$
  x = a+b+c+ \newline
  d+e+f+g
  $$
  

• Alignment

  You can use the aligned environment to achieve alignment, and&to identify fixed anchor points

  $$\begin{array}{rl}x=& a+b+c+\\ & d+e+f+g\end{array}$$$$\begin{array}{rlrl}10& x+& 3& y=2\\ 3& x+& 13& y=4\end{array}$$

  $$
  \begin{aligned}
  x ={}& a+b+c+{} \\
  &d+e+f+g
  \end{aligned}
  $$
  
  $$
  \begin{alignedat}{2}
     10&x+ &3&y = 2 \\
     3&x+&13&y = 4
  \end{alignedat}
  $$
  

Formula Group

Formula groups that do not require alignment can use the gather environment.

$$\begin{array}{c}a=b+c+d\\ x=y+z\end{array}$$

$$
\begin{gathered}
a = b+c+d \\
x = y+z
\end{gathered}
$$

Numbering

$$\begin{array}{}\text{(1)}& x+y^{2x}\end{array}$$$$\begin{array}{}\text{1}& x+y^{2x}\end{array}$$

$\tag{1} x+y^{2x}$

$\tag*{1} x+y^{2x}$

Segmented Functions

Use case environment

$$y=\{\begin{array}{l}-x,x\le 0\\ x,x>0\end{array}$$

$$
y= \begin{cases}
-x,\quad x\leq 0 \\
x,\quad x>0
\end{cases}
$$

Text

To insert text in TeX, you should use \text{} to wrap them.