博客写作时的一些规范和特殊用法参考。同时作为 Markdown 渲染时的标准参考文件。

---

File

1. 使用文件名为链接名，因此使用英文，用 - 代替空格
2. Front Matter 中写上 date 和 lastmod 属性

Markdown

Markdown 语法参考

脚注

示例¹

标题引用

可以为标题增加 ID，以便在文内引用

Callout

Image Caption

Mermaid Graph

Mermaid 语法参考

  pie
"Dogs" : 386
"Cats" : 85
"Rats" : 15

Grammar

1. 推导数学公式时加入:，表示下面的公式与本段有关，除非有连接词
2. 中文使用直角引号「」
3. 中文和英文之间空格
4. 数字和单位之间空格，如 8 GB

Math

基本知识

• 注释以 % 开头

• 颜色：${\color{red} a + b =} c$

• 分数如果分子分母只有一个符号则可以省去括号：$\frac 1 2$

• 盒装公式：$\boxed{a+b}$

• 对比 $|-k|, \lvert - k\rvert, |{-k}|$; $\lVert -k \rVert, \|-k\|$

• \mod 相关：$a\mod b$, $a\pmod b$, $a\bmod b$

• 数学推导：$\implies, \iff$

• $$ \cfrac{1}{\sqrt{2}+ \cfrac{1}{\sqrt{2}+ \cfrac{1}{\sqrt{2}+\dotsb }}} $$
• $$ \begin{gather*} \sum_a \qquad \sum\nolimits_a \\ \int_a \qquad \int\limits_a \end{gather*} $$
• $$ \sum_{\substack{ 0\le i\le m \\ 0 < j < n}} P(i,j) $$

• \text 表示 text，\mathrm 表示数学符号，\operatorname 表示函数

Spacing

Code	Description
\quad	space equal to the current font size
\,	3/18 of \quad
\:	4/18 of \quad
\;	5/18 of \quad
\!	-3/18 of \quad
\ (space after backslash)	equivalent of space in normal text
\qquad	twice of \quad

$$ \begin{align*} f(x) &= x^2\! +3x\! +2 \\ f(x) &= x^2+3x+2 \\ f(x) &= x^2\, +3x\, +2 \\ f(x) &= x^2\: +3x\: +2 \\ f(x) &= x^2\; +3x\; +2 \\ f(x) &= x^2\ +3x\ +2 \\ f(x) &= x^2\quad +3x\quad +2 \\ f(x) &= x^2\qquad +3x\qquad +2 \end{align*} $$$$ \begin{align*} 3ax+4by=5cz\\ 3ax<4by+5cz \end{align*} $$

因此在定义自己的运算符时应确定是二元运算符 \mathbin{\#} 还是关系运算符 \mathrel{\#}

字体

默认拉丁字母、小写希腊字母是斜体，阿拉伯数字、大写希腊字母是罗马体

对字母有效：（一般用来表示特殊集合）

• \mathbb: 黑板粗体
• \mathcal: 手写体（无小写）
• \mathscr: 花体
• \mathfrak: 哥特体

$$ \begin{align*} &RQSZ & &rqsz \\ &\mathbb{RQSZ} & &\mathbb{rqsz} \\ &\mathcal{RQSZ} & &\mathcal{rqsz} \\ &\mathscr{RQSZ} & &\mathscr{rqsz} \\ &\mathfrak{RQSZ} & &\mathfrak{rqsz} \end{align*} $$$$ \begin{align*} 3x^2 \in R \subset Q \\ \mathnormal{3x^2 \in R \subset Q} \\ \mathrm{3x^2 \in R \subset Q} \\ \mathit{3x^2 \in R \subset Q} \\ \mathbf{3x^2 \in R \subset Q} \\ \mathsf{3x^2 \in R \subset Q} \\ \mathtt{3x^2 \in R \subset Q} \end{align*} $$

Display Math

主环境

$$ \begin{equation} e^{\pi i} + 1 = 0 \end{equation} $$$$ \begin{multline} p = 1+2+3 \\ +4+5+6 \\ +7+8+9+10+11 \\ +12+13+14 \end{multline} $$$$ \begin{gather} 2x - 5y = 8 \\ 3x^2 + 9y = 3a + c \end{gather} $$$$ \begin{align} x&=y & w &=z & a&=b+c\\ 2x&=-y & 3w&=\frac{1}{2}z & a&=b\\ -4 + 5x&=2+y & w+2&=-1+w & ab&=cb \end{align} $$$$ \begin{alignat}{3} & m \quad && \text{módulo} \quad && m>0\\ & a \quad && \text{multiplicador} \quad && 0 主环境都可以在名字最后加入 * 来抑制自动编号

从属环境

$$ \begin{equation} \begin{split} \cos 2x &= \cos^2 x - \sin^2 x \\ &= 2\cos^2 x - 1 \end{split} \end{equation} $$$$ \require{mathtools} \begin{gather*} f(x) = \begin{cases} \frac{x+1}{4}, & \text{if } 0 < x < 1; \\ \max_{x} g(x), & \text{otherwise}. \end{cases} \\ f(x) = \begin{dcases} \frac{x+1}{4}, & \text{if } 0 < x < 1; \\ \max_{x} g(x), & \text{otherwise}. \end{dcases} \end{gather*} $$

其它从属环境：multlined, gathered, aligned, alignedat

其它

MathJax 尚不支持从属编号环境 subequations

自定义

宏TODO

$$ \def\specialFrac#1#2{\frac{x + #1}{y + #2}} \specialFrac{7}{z+3} $$$$ \DeclarePairedDelimiters\norm{\lVert}{\rVert} % require{\mathtools} \norm{v}_2 \quad \norm{\frac 1 2} \quad \norm*{\frac 1 2} \quad \norm[\Bigg]{v} $$

自定义数学符号

$$ \DeclareMathOperator*{\argmin}{arg\,min\,} \DeclareMathOperator{\argmax}{arg\,max\,} \begin{gather} \argmin_x \\ \argmax_x \\ \operatorname{rank}{x} \end{gather} $$

MathJax Extensions

$$ \toggle{math1}{math2}\endtoggle $$$$ \require{physics} $$$$ \require{centernot} \centernot\implies \qquad \not\implies $$

mathtools:

自定规范

下面是一些自己制定的规范，用来更好的统一自己的写作，非强制

1. Expectation: $\mathbb{E}$
2. Set: $\mathbb{R}, \mathbb{Z}$
3. Empty set: $\varnothing$
4. Gaussian: $\mathcal{N}$
5. Conditional probability: $p(a | b)$
6. Set with conditions: $\{a \mid a\in A\}$
7. $i$-th

---

1. 这是一个脚注 ↩︎