Markdown语法

Mon, 11 Mar 2019 00:00:00 +0000

本文提供了可用于 Hugo 内容文件的基本 Markdown 语法示例，还显示了 Hugo 主题中的基本 HTML 元素是否使用 CSS 进行修饰。

标题

如下的 <h1>—<h6> 显示了标题的6个级别， <h1> 级别最高， <h6> 级别最低.

1# H1
2## H2
3### H3
4#### H4
5##### H5
6###### H6

文本类型

加粗与斜体

加粗：**文本** → 文本

斜体：*文本* → 文本

下划线

<span style="text-decoration: wavy underline;"> 天津大学是中国第一所现代大学。 </span> → 天津大学是中国第一所现代大学。

<u> 2025年将迎来天津大学130周年校庆。 </u> → 2025年将迎来天津大学130周年校庆。

上下标

H<sub>2</sub>O → H₂O

X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup> → Xⁿ + Yⁿ = Zⁿ

方框与高亮显示

按下 <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd> 以结束段落。 → 按下 CTRL + ALT + Delete 以结束段落。

<mark>兴学强国</mark>的使命，<mark>实事求是</mark>的校训，<mark>严谨治学</mark>的校风，<mark>矢志创新</mark>的追求。 → 兴学强国的使命，实事求是的校训，严谨治学的校风，矢志创新的追求。

段落

普通段落

马克思主义者认为，只有人们的社会实践，才是人们对于外界认识真理性的标准。实际的情形是这样的，只有在社会实践过程中（物质生产过程中，阶级斗争过程中，科学实验过程中），人们达到了思想中所预想的结果时，人们的认识才被证实了。人们要想得到工作的胜利即得到预想的结果，一定要使自己的思想合于客观外界的规律性，如果不合，就会在实践中失败。人们经过失败之后，也就从失败取得教训，改正自己的思想使之适合于外界的规律性，人们就能变失败为胜利，所谓“失败是成功之母”，“吃一堑长一智”，就是这个道理。

段落类型

首行缩进：<p style="text-indent: 2em;margin-top: 0;margin-bottom: 0;"> 文本 </p>，其中margin-top: 0表示忽略段前空行，margin-bottom: 0表示忽略段后空行。

示例：

君子曰：学不可以已。

青，取之于蓝而青于蓝；冰，水为之而寒于水。木直中绳，輮以为轮，其曲中规。虽有槁暴，不复挺者，輮使之然也。故木受绳则直，金就砺则利，君子博学而日参省乎己，则知明而行无过矣。

吾尝终日而思矣，不如须臾之所学也；吾尝跂而望矣，不如登高之博见也。登高而招，臂非加长也，而见者远；顺风而呼，声非加疾也，而闻者彰。假舆马者，非利足也，而致千里；假舟楫者，非能水也，而绝江河。君子生非异也，善假于物也。

积土成山，风雨兴焉；积水成渊，蛟龙生焉；积善成德，而神明自得，圣心备焉。故不积跬步，无以至千里；不积小流，无以成江海。骐骥一跃，不能十步；驽马十驾，功在不舍。锲而舍之，朽木不折；锲而不舍，金石可镂。蚓无爪牙之利，筋骨之强，上食埃土，下饮黄泉，用心一也。蟹六跪而二螯，非蛇鳝之穴无可寄托者，用心躁也。

居中：<div style="text-align: center;"> 文本 </div>或<center> 文本 </center>
左对齐：默认
右对齐：<div style="text-align: right;"> 文本 </div>

引用

引用元素表示从另一个来源引用的内容，可以选择引用必须在footer或cite元素内，也可以选择内联更改，如注释和缩写。

不含注解的引用

Tiam, ad mint andaepu dandae nostion secatur sequo quae. Note that you can use Markdown syntax within a blockquote.

包含注解的引用

不积跬步，无以至千里；不积小流，无以成江海。
——— 荀子¹

表格

表格不是Markdown语法的核心功能，但是Hugo同样为其提供了支持。

姓名	年级	专业
张三	2024级	计算机科学与技术
李四	2023级	软件工程

行内列表

斜体	加粗	代码
italics	bold	`code`

A	B	C	D	E	F
Lorem ipsum dolor sit amet, consectetur adipiscing elit.	Phasellus ultricies, sapien non euismod aliquam, dui ligula tincidunt odio, at accumsan nulla sapien eget ex.	Proin eleifend dictum ipsum, non euismod ipsum pulvinar et. Vivamus sollicitudin, quam in pulvinar aliquam, metus elit pretium purus	Proin sit amet velit nec enim imperdiet vehicula.	Ut bibendum vestibulum quam, eu egestas turpis gravida nec	Sed scelerisque nec turpis vel viverra. Vivamus vitae pretium sapien

代码块

使用三个竖撇号包裹

 1<!doctype html>
 2<html lang="en">
 3<head>
 4  <meta charset="utf-8">
 5  <title>Example HTML5 Document</title>
 6</head>
 7<body>
 8  <p>Test</p>
 9</body>
10</html>

使用Tab缩进表示

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Example HTML5 Document</title>
</head>
<body>
  <p>Test</p>
</body>
</html>

自动代码高亮

 1<!doctype html>
 2<html lang="en">
 3<head>
 4  <meta charset="utf-8">
 5  <title>Example HTML5 Document</title>
 6</head>
 7<body>
 8  <p>Test</p>
 9</body>
10</html>

代码比较

1[dependencies.bevy]
2git = "https://github.com/bevyengine/bevy"
3rev = "11f52b8c72fc3a568e8bb4a4cd1f3eb025ac2e13"
4- features = ["dynamic"]
5+ features = ["jpeg", "dynamic"]

列举类

有序列举

11. 项目一
22. 项目二
33. 项目三

效果：

项目一
项目二
项目三

无序列举

1* 项目
2* 另一个项目
3* 再一个项目

效果：

项目
另一个项目
再一个项目

嵌套列举

1* Fruit
2  * Apple
3  * Orange
4  * Banana
5* Dairy
6  * Milk
7  * Cheese

效果：

Fruit
- Apple
- Orange
- Banana
Dairy
- Milk
- Cheese

在Markdown中使用Tex

在Markdown文件中，Tex文本须使用 $…$ （行内文本）或$$…$$（行间文本）包裹.

注意：若要在行内文本中显示行间文本的样式，须加上\displaystyle.

数学符号

符号	语法	示例
空格	`a\ b`	$a\ b$
小于	`a < b` 空格不能少	$a < b$
大于	`a < b` 空格不能少	$a > b$
小于等于	`\leqslant`	$a \leqslant b$
大于等于	`\geqslant`	$a \geqslant b$
点乘	`\cdot`	$A \cdot B$
叉乘	`\times`	$ A \times B $
正负号	`\pm`	$ \pm a $
角	`\angle`	$\angle ABC $
三角形	`\triangle`	$\triangle ABC $
向量	`\overrightarrow{}`	$\overrightarrow{AB}$
推出	`\Rightarrow`	$A \Rightarrow B$
等价于	`\Leftrightarrow`	$ A \Leftrightarrow B $
粗体	`\boldsymbol{}`	$\boldsymbol{a}$
正体	`\mathrm{}`	$\mathrm{d}x$

字母	LaTeX 命令	字母	LaTeX 命令	字母	LaTeX 命令	字母	LaTeX 命令
α	`\alpha`	ν	`\nu`	Α	`\Alpha`	Ν	`\Nu`
β	`\beta`	ξ	`\xi`	Β	`\Beta`	Ξ	`\Xi`
γ	`\gamma`	ο	`\omicron`	Γ	`\Gamma`	Ο	`\Omicron`
δ	`\delta`	π	`\pi`	Δ	`\Delta`	Π	`\Pi`
ε	`\epsilon`	ρ	`\rho`	Ε	`\Epsilon`	Ρ	`\Rho`
ζ	`\zeta`	σ	`\sigma`	Ζ	`\Zeta`	Σ	`\Sigma`
η	`\eta`	τ	`\tau`	Η	`\Eta`	Τ	`\Tau`
θ	`\theta`	υ	`\upsilon`	Θ	`\Theta`	Υ	`\Upsilon`
ι	`\iota`	φ	`\phi`	Ι	`\Iota`	Φ	`\Phi`
κ	`\kappa`	χ	`\chi`	Κ	`\Kappa`	Χ	`\Chi`
λ	`\lambda`	ψ	`\psi`	Λ	`\Lambda`	Ψ	`\Psi`
μ	`\mu`	ω	`\omega`	Μ	`\Mu`	Ω	`\Omega`

公式	语法	示例
分式	`\frac{a}{b}`	$\displaystyle \frac{a}{b}$
幂	`a^{m}`	$ a^{m} $
根式	`\sqrt{2}`	$\sqrt{2}$
高次根式	`\sqrt[n]{m}`	$\sqrt[n]{m}$
下标	`a_{n}`	$ a_{n} $
方程组	`\left\{ \begin{array}{c} \end{array} \right.`	$$\left\{ \begin{array}{c} F(x,y,u,v) = 0 \\ G(x,y,u,v) = 0 \end{array} \right.$$

导数与微分

公式	语法	示例
极限	`\lim_{x \to 0}`	$\displaystyle \lim_{x \to 0}$
二重极限	`\lim_{\substack{\Delta x \to 0 \\ \Delta y \to 0}}`	$$\lim_{\substack{\Delta x \to 0 \\ \Delta y \to 0}} f(x,y)$$
导数	`f \'(x)`	$ f'(x) $
	`\frac{\mathrm{d}y}{\mathrm{d}x}`	$\displaystyle \frac{\mathrm{d}y}{\mathrm{d}x} $
	`f^{(n)}(x)`	$f^{(n)}(x)$
偏导	`\partial`	$\displaystyle \frac{\partial z}{\partial x}$

求和与积分

公式	语法	示例
求和	`\sum_{i=0}^{n}`	$\displaystyle \sum_{i=0}^{n} a_i$
求积	`\prod_{i=0}^{n}`	$\displaystyle \prod_{i=0}^{n} a_i $
积分	`\int_{a}^{b}`	$\displaystyle \int_{a}^{b} f(x) \mathrm{d}x$
	`\iint\limits_D`	$\displaystyle \iint\limits_D f(x,y) \mathrm{d}x \mathrm{d}y$
	`\oint_{L}`	$\displaystyle \oint_{L} f(x,y,z) \mathrm{d}l$
	`\oiint\limits_{\varSigma}`	$\displaystyle \oiint\limits_{\varSigma} f(x,y,z) \mathrm{d}S$

行列式与矩阵

矩阵：

1\left[
2\begin{matrix}
3a & a+b \\    # '&'是占位符，'\\'是换行符
4c+d & d \\
5\end{matrix}
6\right]

效果：

$$\left[\begin{matrix} a & a+b \\ c+d & d \\ \end{matrix} \right]$$

在等号处对齐

使用{align*}环境，在每一行公式后加上\\；在要对齐的等号前加上&。

1$$ 
2\begin{align*} 
3x_1+x_2 &= \frac{-b+\sqrt{b^{2}-4ac}}{2a} + \frac{-b-\sqrt{b^{2}-4ac}}{2a} \\ &= -\frac{b}{a}
4\end{align*}
5$$

效果：

$$ \begin{align*} x_1+x_2 &= \frac{-b+\sqrt{b^{2}-4ac}}{2a} + \frac{-b-\sqrt{b^{2}-4ac}}{2a} \\ &= -\frac{b}{a} \end{align*}$$

其他

隐藏内容

1<details>
2      <summary>点击展开隐藏内容</summary>
3      
4隐藏内容
5</details>

效果：

点击展开隐藏内容

隐藏内容

参考资料

1[图片文件](网址)

→

荀子，中国古代哲学家。 ↩︎

Markdown on RunicDolphin806

Markdown语法

标题

文本类型

加粗与斜体

下划线

上下标

方框与高亮显示

段落

普通段落

段落类型

引用

不含注解的引用

包含注解的引用

表格

行内列表

代码块

使用三个竖撇号包裹

使用Tab缩进表示

自动代码高亮

代码比较

列举类

有序列举

无序列举

嵌套列举

在Markdown中使用Tex

数学符号

导数与微分

求和与积分

行列式与矩阵

在等号处对齐

其他

隐藏内容

参考资料