本文提供了可用于 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 → H2O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup> → Xn + Yn = Zn
方框与高亮显示
按下 <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.
包含注解的引用
不积跬步，无以至千里；不积小流，无以成江海。
——— 荀子1
表格
表格不是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[图片文件](网址)
→ 
-
荀子，中国古代哲学家。 ↩︎