示例

博客	备注
查尔斯的知识库
mermaid 时序图	live editor

markdown 语法

自定义容器

警告

VuePress v2 目前仍处于

提示

• 使用 pnpm 时，你需要安装 vue 作为 peer-dependencies 。
• 使用 yarn 2+ 时，你需要在 .yarnrc.yml 文件中设置 nodeLinker: 'node-modules' 。 :::

示例 .gitignore 文件

.vuepress/.temp
# VuePress 默认缓存目录
.vuepress/.cache
# VuePress 默认构建生成的静态文件目录
.vuepress/dist

这是添加的标题

tip 后直接跟标题

无序列表

• 当前工作目录 cwd 下：
  • vuepress.config.ts
  • vuepress.config.js
  • vuepress.config.mjs
• 源文件目录 sourceDir 下：
  • .vuepress/config.ts
  • .vuepress/config.js
  • .vuepress/config.mjs

---

• 红色
• 绿色
  • 红色
  • 绿色
• 蓝色

有序列表

1. 红色
2. 绿色
3. 蓝色

引用文字

这是一个有两段的块引用。这是第一段。 这是第二段。Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. 这是另一个只有一个段落的块引用。有三个空行分隔两个块引用。

水平线

---

选择框和对号

• [ ] 作者靠才华吃饭
• [x] 作者靠颜值吃饭

强调（斜体）

单个星号

单个下划线

*这个文字被文字星号包围*

要在用作强调分隔符的位置生成文字星号或下划线，可以用反斜杠转义

粗体

双星号

双重下划线

代码

使用printf()函数。

删除线

错误的文字。

下划线

下划线

徽标

Title default Title ^1.9.0 Title beta Title caution

表情符号

😄 😢 🐷

CodeGroup

正例

# email 不是主键，也没有设置唯一约束，根据熵增定律，查询结果是有可能会出现多条的
SELECT * FROM `sys_user` WHERE `email` = 'charles7c@126.com' LIMIT 1;

反例

# user_id 是主键，主键是非空唯一的，那么不需要添加 LIMIT 进行限制
SELECT * FROM `sys_user` WHERE `user_id` = 1;

空格

海阔$$天空

  插入一个空格   插入两个空格   插入四个空格   插入细空格

示例： 海阔 天空 海阔 天空 海阔 天空 海阔 天空

GitHub 风格的警报

NOTE

强调用户在快速浏览文档时也不应忽略的重要信息。

TIP

有助于用户更顺利达成目标的建议性信息。

IMPORTANT

对用户达成目标至关重要的信息。

WARNING

因为可能存在风险，所以需要用户立即关注的关键内容。

CAUTION

行为可能带来的负面影响。

代码组

config.js

/**
 * @type {import('vitepress').UserConfig}
 */
const config = {
	// ...
}

export default config

config.ts

import type { UserConfig } from 'vitepress'

const config: UserConfig = {
	// ...
}

export default config

HTML

this text is red

表格

类别	名称
颜色	红色
	黄色
姓氏
王	张

CSW 命令状态封包
偏移	位
	7	6	5	4	3	2	1	0

组件

你可以在 Markdown 中直接使用 Vue 组件。

输入

这是默认主题内置的 `<Badge />` 组件 <Badge text="演示" />

输出

这是默认主题内置的 <Badge /> 组件 演示

iframe

代码区别

- module.exports = {
-   theme: '@vuepress/theme-default',
-   themeConfig: {
-     // 默认主题配置
-   },
- }

+ import { defaultTheme } from '@vuepress/theme-default'
+ import { defineUserConfig } from 'vuepress'
+
+ export default defineUserConfig({
+   theme: defaultTheme({
+     // 默认主题配置
+   })
+ })

反撇号`

`

原生显示 md 代码

```ts{1,7-9}
import { defaultTheme } from '@vuepress/theme-default'
import { defineUserConfig } from 'vuepress'

export default defineUserConfig({
  title: '你好， VuePress',

  theme: defaultTheme({
    logo: 'https://vuejs.org/logo.png',
  }),
})
```

徽章

制作徽章

上下标

在Markdown中，上标和下标可以通过HTML的<sup>和<sub>标签来实现。

H₂O

脚注

先帝创业未半 ^[1]

vue

你好， Markdown 中的 Vue

当前计数为： 0

mermaid

mermaid docs， live editor

数学公式

原文链接

markdown 公式大全 \ typora 常用的数学公式编辑语法 \ Markdown 常用数学公式

一、基本格式

行内公式

在两个美元符号中输入公式即可。

如$E=m\times c^2$ 效果：$E=m\times c^2$ （注：\times 是乘的意思）

整行公式

在四个美元符号中输入公式，如果想要给公式后面添加编号，那么在公式后添加空格 + \tag{1}就可以了。

如$$ \sum_{i=0}^n i^2=\frac{(n^2+n)(2n+1)}{6} \tag{1} $$，效果：

$$\begin{array}{}\text{(4)}& \{[(x_1+x_2{)}^2-(y_1-y_2{)}^4]\times w\}\times (z_1^2-z_2^2)\end{array}$$

上标与下标

用_表示下标，^表示上标。

如$$ x_i^3+y_i^3=z_i^3 \tag{2} $$，效果：

$$\begin{array}{}\text{(2)}& x_i^3+y_i^3=z_i^3\end{array}$$

如$$ MSE=\sum_{i=1}^n (w\times x_i+b-y_i)^2 \tag{3} $$，效果：

$$\begin{array}{}\text{(3)}& MSE=\sum _{i=1}^n(w\times x_i+b-y_i{)}^2\end{array}$$

A_1^2
\\
B_{12}
\\
2^{x^2+y}

$$\begin{gathered} A_1^2 \\ {B}_{12} \\ {2}^{x^2+y} \end{gathered}$$

括号

()和[] 可以直接输入，但花括号{ }前面需要加转义符号\。

如$$ \{[(x_1+x_2)^2-(y_1-y_2)^4]\times w\}\times (z_1^2-z_2^2) \tag{4} $$ ，效果：

$$\begin{array}{}\text{(4)}& \{[(x_1+x_2{)}^2-(y_1-y_2{)}^4]\times w\}\times (z_1^2-z_2^2)\end{array}$$

运算符

并集

$$\bigcup _{i=1}^2\mathbb{R}$$

交集

$$\bigcap _{i=1}^3$$

三角函数

如$$ \sin(x+y)+\cos(y+z)+\tan(z+x)+\arcsin(x+y+z) \tag{7}$$，效果：

$$\begin{array}{}\text{(7)}& \sin (x+y)+\cos (y+z)+\tan (z+x)+\arcsin (x+y+z)\end{array}$$

对数

如$\log_2 10$，效果：${\log }_{2}10$

如$\lg 10^3$，效果：$\lg {10}^3$

如$\ln (\pi+2)$，效果：$\ln (\pi +2)$

积分、导数

如$g(x)=\frac{\partial f(x,y)}{\partial x}$，效果：$g(x)=\frac{\partial f(x,y)}{\partial x}$

如$\int_a^{+\infty} x^2 \sin(x^3 +1)dx$，效果：${\int }_a^{+\mathrm{\infty }}{x}^2\sin (x^3+1)dx$

如$$\displaystyle\int_0^{+\infty} \frac{1}{\sqrt{2\pi}}e^{-\frac {x^2}{2}}dx=\frac{1}{2} \tag{8}$$，效果：

$$\begin{array}{}\text{(8)}& {\displaystyle {\int }_0^{+\mathrm{\infty }}\frac{1}{\sqrt{2\pi }}{e}^{-\frac{x^2}{2}}dx=\frac{1}{2}}\end{array}$$

开根号

如$\sqrt{x+y}$，效果：$\sqrt{x+y}$

如$\sqrt[n]{a + b}$，效果：$\sqrt{x+y}$

\sqrt{x}
\sqrt[3]{x}

$$\sqrt{x}\sqrt[3]{x}$$

分数

\frac{x}{1+x^2}
\\
\frac{\frac{1}{2}+x}{y}
\\
\tfrac{a}{b}
\frac{a}{b}

$$\begin{gathered} \frac{x}{1+x^2} \\ \frac{\frac{1}{2}+x}{y} \\ \frac{a}{b}\frac{a}{b} \end{gathered}$$

组合数

\binom{n}{k}
\tbinom{n}{k}

$$(\genfrac{}{}{0ex}{}{n}{k})(\genfrac{}{}{0ex}{}{n}{k})$$

导数

a'
a''
a^{\prime}

$$a^{\prime }{a}^{″}{a}^{\prime }$$

取模

x \pmod a
\\
2\mod{x}

$$\begin{gathered} x(\mathrm{mod}a) \\ 2\mathrm{mod}x \end{gathered}$$

微分

\nabla
\partial x
\mathrm{d}x
\dot x
\ddot y
\Delta

$$\mathrm{\nabla }\partial x\mathrm{d}x\dot{x}\ddot{y}\mathrm{\Delta }$$

累加

累加：使用 \sum_{下标表达式}^{上标表达式}

如$$ Y_i=\sum_{i=0}^{n} X_i \tag{5} $$，效果：

$$\begin{array}{}\text{(5)}& Y_i=\sum _{i=0}^n{X}_i\end{array}$$

累积

\sum_{i=1}^{k}
\displaystyle\sum_{i=1}^n
\textstyle\sum_{i=1}^n

$$\sum _{i=1}^k{\displaystyle \sum _{i=1}^n\sum _{i=1}^n}$$

累乘

\prod_{i=1}^{k}
\displaystyle\prod_{i=1}^n
\textstyle\prod_{i=1}^n

$$\prod _{i=1}^k{\displaystyle \prod _{i=1}^n\prod _{i=1}^n}$$

极限

\lim_{k \to \infty}
\lim\limits_{k \to \infty}
\lim\nolimits_{k \to \infty}]

$$\underset{k\to \mathrm{\infty }}{lim}\underset{k\to \mathrm{\infty }}{lim}{lim}_{k\to \mathrm{\infty }}]$$

二、修饰符号

1. 简单的帽子

\hat{\theta}
\widehat{AB}
\\
\bar{y}
\overline{AB}
\\
\tilde{a}
\widetilde{ac}
\\
\bar{a}
\acute{a}
\check{a}
\grave{a}
\\
\dot{a}
\ddot{a}

$$\begin{gathered} \hat{\theta }\widehat{AB} \\ \overline{y}\overline{AB} \\ \tilde{a}\widetilde{ac} \\ \overline{a}\acute{a}\check{a}\stackrel{`}{a} \\ \dot{a}\ddot{a} \end{gathered}$$

2. 盒子和帽子

\overbrace{a+b+c}^{\text{note}}
\\
\underbrace{a+b+c}_{\text{note}}
\\
\boxed{\pi=3.14}

$$\begin{gathered} \stackrel{\text{note}}{\overbrace{a+b+c}} \\ \underset{\text{note}}{\underbrace{a+b+c}} \\ \boxed{{\displaystyle \pi =3.14}} \end{gathered}$$

3. 各种括号

(
\big(
\Big(
\bigg(
\Bigg(

$$((((($$

[]
<>
|-2|
\{\}

$$[]<>|-2|\{\}$$

\lgroup x \rgroup
\lVert a \rVert
\lceil 2.6 \rceil
\lfloor 1.2 \rfloor

$$⟮x⟯\Vert a\Vert \lceil 2.6\rceil \lfloor 1.2\rfloor$$

\ulcorner
\urcorner
\llcorner
\lrcorner

$$⌜⌝⌞⌟$$

三、希腊字母

四、算术运算符号

+
-
\times
/
\div
\cdot
\#
\%

$$+-\times /÷\cdot \mathrm{\#}\mathrm{\%}$$

\circ
\ast
\star
\otimes
\oplus
\odot

$$\circ \ast \star \otimes \oplus \odot$$

\pm
\mp
\dotplus
\divideontimes

$$\pm \mp \dotplus \divideontimes$$

五、比较运算符

=
= \not
\equiv
\approx
\approxeq
\cong
\sim
\neq
\not=

$$==\not\equiv \approx \approxeq \cong \sim \ne \ne$$

<
>
\le
\ge
\gg
\ll

$$<>\le \ge \gg \ll$$

\curlyeqprec
\curlyeqsucc
\prec
\succ
\preceq
\succeq

$$⋞⋟\prec \succ ⪯⪰$$

六、集合运算符

\in
\owns \not
\subset \not
\supset
\subseteq
\supseteq
\\
\cap
\cup
\land
\lor
\\
\neg
\emptyset
\varnothing
\\
\because
\forall
\exists
\therefore

$$\begin{gathered} \in \ni \not\subset \not\supset \subseteq \supseteq \\ \cap \cup \wedge \vee \\ \mathrm{\neg }\mathrm{\varnothing }\varnothing \\ \because \mathrm{\forall }\mathrm{\exists }\therefore \end{gathered}$$

\cap
\cup
\land
\lor
\sqcup
\sqcap

$$\cap \cup \wedge \vee \bigsqcup \sqcap$$

七、各种箭头

\gets
\leftarrow
\to
\rightarrow
\leftrightarrow
\\
\uparrow
\downarrow
\updownarrow

$$\begin{gathered} \leftarrow \leftarrow \to \to \leftrightarrow \\ \uparrow \downarrow \updownarrow \end{gathered}$$

\Leftarrow
\Rightarrow
\Leftrightarrow
\iff
\\
\Uparrow
\Downarrow
\Updownarrow

$$\begin{gathered} \Leftarrow \Rightarrow \iff ⟺ \\ \Uparrow \Downarrow \Updownarrow \end{gathered}$$

\nearrow
\searrow
\swarrow
\nwarrow

$$\nearrow \searrow \swarrow \nwarrow$$

\longleftarrow
\longrightarrow
\longleftrightarrow
\Longleftarrow
\Longrightarrow
\Longleftrightarrow
\longmapsto

$$⟵⟶⟷⟸⟹⟺⟼$$

\xrightarrow{over}
\xrightarrow[over]{}
\xrightarrow[under]{over}
\xleftarrow[]{over}
\xleftarrow[under]{}
\xleftarrow[under]{over}

$$\stackrel{over}{\to }\underset{over}{\overset{}{\to }}\underset{under}{\overset{over}{\to }}\stackrel{over}{\leftarrow }\underset{under}{\overset{}{\leftarrow }}\underset{under}{\overset{over}{\leftarrow }}$$

八、空间间距

A\!B
\\
AB
\\
A\thinspace B
\\
A\:B
\\
A\ B
\\
A \enspace B
\\
A\quad B
\\
A\qquad B

$$\begin{gathered} AB \\ AB \\ AB \\ AB \\ AB \\ AB \\ AB \\ AB \end{gathered}$$

九、矩阵

A = \begin{matrix}
a & b\\
c & d
\end{matrix}

$$A=\begin{array}{cc}a& b\\ c& d\end{array}$$

B = \begin{pmatrix}
a & b\\
c & d
\end{pmatrix}

$$B=\left(\begin{array}{cc}a& b\\ c& d\end{array}\right)$$

D = \begin{bmatrix}
a & b\\
c & d
\end{bmatrix}

$$D=\left[\begin{array}{cc}a& b\\ c& d\end{array}\right]$$

E = \begin{Vmatrix}
a & b\\
c & d
\end{Vmatrix}

$$E=\Vert \begin{array}{cc}a& b\\ c& d\end{array}\Vert$$

F = \begin{Bmatrix}
a & b\\
c & d
\end{Bmatrix}

$$F=\left\{\begin{array}{cc}a& b\\ c& d\end{array}\right\}$$

[A\ b] =
\begin{bmatrix}
\begin{array}{c c c|c}
a_{11} & a_{12} & a_{13} & b_1\\
a_{21} & a_{22} & a_{23} & b_2\\
a_{31} & a_{32} & a_{33} & b_3\\
\end{array}
\end{bmatrix}

$$[Ab]=\left[\begin{array}{c}\begin{array}{cccc}{a}_{11}& a_{12}& a_{13}& b_1\\ a_{21}& a_{22}& a_{23}& b_2\\ a_{31}& a_{32}& a_{33}& b_3\end{array}\end{array}\right]$$

\begin{array}{c:c:c}
a & b & c \\
\hline
d & e & f \\
\hdashline
 g & h & i
\end{array}

$$\begin{array}{ccc}a& b& c\\ d& e& f\\ g& h& i\end{array}$$

L_{n\times n} = \begin{bmatrix}
a_{11} & a_{12} & \cdots & a_{1n} \\
a_{21} & a_{22} & \cdots & a_{2n} \\
\vdots & \vdots &\ddots & \vdots\\
a_{n1} & a_{n2} & \cdots & a_{nn} \\
\end{bmatrix}

$$L_{n\times n}=\left[\begin{array}{cccc}{a}_{11}& a_{12}& \cdots & a_{1n}\\ a_{21}& a_{22}& \cdots & a_{2n}\\ ⋮& ⋮& \ddots & ⋮\\ a_{n1}& a_{n2}& \cdots & a_{nn}\end{array}\right]$$

十、列式/方程组

\begin{aligned}
f(x) &= (x+1)^2\\
&= x^2 + 2x + 1
\end{aligned}

$$\begin{array}{rl}f(x)& =(x+1{)}^2\\ & =x^2+2x+1\end{array}$$

f(x) = \begin{cases}
a &\text{if b}\\
b &\text{if a}\\
\end{cases}

$$f(x)=\{\begin{array}{ll}a& \text{if b}\\ b& \text{if a}\end{array}$$

\begin{cases}
\begin{aligned}
x + 2y &= 1\\
3x - y &= 5
\end{aligned}
\end{cases}

$$\{\begin{array}{l}\begin{array}{rl}x+2y& =1\\ 3x-y& =5\end{array}\end{array}$$

g(x,y)=\left\{
\begin{array}{rcl}
\frac{M_g - d}{M_f-b}[f(x,y)-b]+d       &      & {b      \leq  f(x,y)  \leq M_f}\\
F^*_L     &      & {S_L \leq 0 < S_M}\\
F^*_R     &      & {S_M \leq 0 < S_R}\\
F_R       &      & {S_R \leq 0}
\end{array} \right.

$$g(x,y)=\{\begin{array}{rcl}\frac{M_g-d}{M_f-b}[f(x,y)-b]+d& & b\le f(x,y)\le M_f\\ F_L^{\ast }& & S_L\le 0<S_M\\ F_R^{\ast }& & S_M\le 0<S_R\\ F_R& & S_R\le 0\end{array}$$

十一、修改颜色和字体大小

\textcolor{blue}{F=ma}
\\
\textcolor{#00ff00}{F=ma}
\\
\textcolor{#ff0000}{F=ma}
\\
\color{blue} one\ line
\\
nothing

$$\begin{gathered} F=ma \\ F=ma \\ F=ma \\ oneline \\ nothing \end{gathered}$$

\colorbox{#00ff00}{F=ma}
\\
\colorbox{aqua}{A}
\\
\fcolorbox{red}{aqua}{A}

$$\begin{gathered} \text{F=ma} \\ \text{A} \\ \text{A} \end{gathered}$$

AB
\Huge AB
\huge AB
\\
AB
\LARGE AB
\Large AB
\large AB
\\
AB
\small AB
\tiny AB

$$\begin{gathered} ABABAB \\ ABABABAB \\ ABABAB \end{gathered}$$

十二、划掉

\cancel{5}
\bcancel{5}
\xcancel{ABC}
\not =

$$\cancel{5}\bcancel{5}\xcancel{ABC}\ne$$

十三、常见图形

\Box
\square
\blacksquare
\triangle
\triangledown
\blacktriangle
\diamond
\Diamond
\star
\bigstar
\circ
\bullet
\bigcirc
\bigodot

$$◻◻◼\mathrm{△}▽▴\diamond ◊\star ★\circ \bullet ◯⨀$$

\diamondsuit
\clubsuit
\heartsuit
\spadesuit

$$\mathrm{♢}\mathrm{♣}\mathrm{♡}\mathrm{♠}$$

\angle
\measuredangle
\top
\bot
\infty

$$\mathrm{\angle }\measuredangle \mathrm{\top }\mathrm{\perp }\mathrm{\infty }$$

\checkmark
\dagger
\ddagger
\yen
\$

$$✓†‡\yen \mathrm{\$}$$

十四、声明宏

对于一些复杂但是只有少许不同的表达式，可以声明一个函数来调用，提高源码的可读性，减少出错

\def\macroname#1#2{
your command
}

宏允许带任意数量的参数（也可以不带参），必须是#1,#2,……这样的命名格式，同时注意再定义宏的时候注意让#1与\ 中间隔一个空格，否则会解析成#。再调用的时候格式为\macroname{x}{y}{z}，可以参考一下的例子

\def\Normal#1#2#3{
\frac{1}{\sqrt{2\pi}\ #3}\exp{[-\frac{(#1 - #2)^2}{2\ #3^2}]}
}
f(x)=\Normal{x}{u_1}{\sigma_1}\\
f(y)=\Normal{y}{u_2}{\sigma_2}\\

$$\begin{gathered} f(x)=\frac{1}{\sqrt{2\pi }{\sigma }_1}\exp [-\frac{(x-u_1{)}^2}{2{\sigma }_1^2}] \\ f(y)=\frac{1}{\sqrt{2\pi }{\sigma }_2}\exp [-\frac{(y-u_2{)}^2}{2{\sigma }_2^2}] \end{gathered}$$

\def\EXP{
e^x = 1 + x + \frac{1}{2!}x^2 + \frac{1}{3!}x^3  + \cdots
}
\EXP

$$e^x=1+x+\frac{1}{2!}{x}^2+\frac{1}{3!}{x}^3+\cdots$$

---

1. 诸葛亮《出师表》 ↩︎