跳至主要内容

编写数学表达式

在 GitHub 上使用 Markdown 显示数学表达式。

关于编写数学表达式

为了实现数学表达式的清晰交流,GitHub 支持 Markdown 中的 LaTeX 格式数学。有关详细信息,请参阅 Wikibooks 中的 LaTeX/Mathematics

GitHub 的数学渲染功能使用 MathJax;一个基于 JavaScript 的开源显示引擎。MathJax 支持广泛的 LaTeX 宏和一些有用的辅助功能扩展。有关详细信息,请参阅 MathJax 文档MathJax 辅助功能扩展文档

数学表达式渲染可在 GitHub 问题、GitHub 讨论、请求拉取、wiki 和 Markdown 文件中使用。

编写内联表达式

有两种方法可以在文本中用内联方式定界数学表达式。你可以用美元符号 ($) 括起表达式,或以 $` 开始表达式并以 `$ 结束表达式。当你要编写的表达式包含与 markdown 语法重叠的字符时,后一种语法很有用。有关详细信息,请参阅“基本编写和格式化语法”。

This sentence uses `$` delimiters to show math inline:  $\sqrt{3x-1}+(1+x)^2$

Screenshot of rendered Markdown showing how a mathematical expression displays on GitHub. The equation is the square root of 3 x minus 1 plus open paren 1 plus x close paren squared.

This sentence uses $\` and \`$ delimiters to show math inline:  $`\sqrt{3x-1}+(1+x)^2`$

Screenshot of rendered Markdown showing how a mathematical expression displays inline on GitHub. The equation is the square root of 3 x minus 1 plus open paren 1 plus x close paren squared.

将表达式写成块

要将数学表达式添加为块,请开始新的一行,并用两个美元符号 $$ 将表达式分隔开。

**The Cauchy-Schwarz Inequality**
$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$

Screenshot of rendered Markdown showing how a complex equation displays on GitHub. The bolded text reads "The Cauchy-Schwarz Inequality". Below the text, there is an equation showing open paren the sum from k equals 1 to n of a sub k b sub k close paren squared is less than or equal to open paren the sum from k equals 1 to n of a sub k squared close paren times open paren the sum from k equals 1 to n of b sub k squared close paren.

或者,你可以使用 ```math 代码块语法将数学表达式显示为块。使用此语法,你无需使用 $$ 分隔符。以下内容将呈现与上面相同的结果

**The Cauchy-Schwarz Inequality**

```math
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
```

在数学表达式中和数学表达式内书写美元符号

要在与数学表达式同一行中将美元符号显示为字符,你需要转义非分隔符 $ 以确保行正确呈现。

  • 在数学表达式中,在显式的 $ 前添加一个 \ 符号。

    This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$
    

    Screenshot of rendered Markdown showing how a backslash before a dollar sign displays the sign as part of a mathematical expression.

  • 在数学表达式外部,但在同一行中,在显式的 $ 周围使用 span 标签。

    To split <span>$</span>100 in half, we calculate $100/2$
    

    Screenshot of rendered Markdown showing how span tags around a dollar sign display the sign as inline text rather than part of a mathematical equation.

进一步阅读