Plume 主题

简体中文

English

简体中文

English

外观

在 GitHub 上 Star遇到问题？喝杯奶茶

数学公式

复制页面

约 629 字大约 2 分钟

2025-11-29

概述

主题内置了对 数学公式 的支持。

该功能由 @vuepress/plugin-markdown-math 提供支持。你可以选择在 markdown 中使用以下方式渲染数学公式:

  • katex (默认)
  • mathjax

使用

.vuepress/config.ts
export default defineUserConfig({
  theme: plumeTheme({
    markdown: {
      math: {
        type: 'katex', // 'katex' | 'mathjax'
        // ... 其它配置项
      }
    },
  })
})

当你选择使用 mathjax 时，还需要执行以下命令安装依赖：

pnpm
pnpm add @mathjax/src

语法

内联语法

使用 $ 包裹数学公式 （即在两个 $ 之间编写数学公式）

Euler's identity eiπ+1=0e^{i\pi}+1=0 is a beautiful formula in R2\mathbb{R}^2.

内联模式

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

块级语法

使用 $$ 包裹数学公式 （即在两个 $$ 之间编写数学公式）

<!-- 在两个 `$$` 之间编写数学公式，在单独的块中渲染 -->
$$xxx$$

<!-- 两个 `$$` 可以单独占一行，数学公式在它们之间 -->
$$
xxx
$$

∂r∂ωr(yωω)=(yωω){(log⁡y)r+∑i=1r(−1)Ir⋯(r−i+1)(log⁡y)riωi}\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) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^ Ir \cdots (r-i+1) (\log y)^{ri}} {\omega^i} \right\}
$$

相关教程

TeX

TeX 教程TeX 速查表

KateX

KateX 支持功能KateX 支持列表

Mathjax

支持的 TeX / KateX 命令

配置项

type'katex' | 'mathjax'

'katex'

用于渲染 TeX\TeX 内容的包。

delimitersOptional'brackets' | 'dollars' | 'all'

'dollars'

启用的数学分隔符语法。

  • "brackets": 使用 \(...\) 表示内联数学，使用 \[...\] 表示显示模式数学（LaTeX 风格）
  • "dollars": 使用 $...$ 表示内联数学，使用 $$...$$ 表示显示模式数学（常见 Markdown 风格）
  • "all": 启用括号和美元符号两种语法

使用 KaTeX

使用 KaTeX 时，任何其他选项都将作为 KatexOptions 传递给 KaTeX。有关所有可用选项，请参阅 KaTeX 文档。

此外，还支持 2 个特殊选项：

copyOptionalboolean

false

是否启用复制扩展。

mhchemOptionalboolean

false

是否启用 mhchem 扩展。

使用 MathJax

使用 MathJax 时，你可以设置：

texOptionalobject

传递给 TeX 输入解析器的选项。

outputOptional'svg' | 'chtml'

'svg'

输出格式，SVG 或通用 HTML。

chtmlOptionalobject

传递给通用 HTML 输出解析器的选项。

svgOptionalobject

传递给 SVG 输出解析器的选项。

贡献者

pengzhanbo

更新日志

2025/12/1 03:30
查看所有更新日志
  • db8a4-docs: optimize and completion docs (#766)于