Markdown 是一种轻量级标记语言，使用纯文本即可完成基本排版与结构标记，常用于文档编写、博客写作、技术说明与笔记整理等场景；其设计目标易读、易写，并支持转换为 HTML、PDF 等多种格式，在不同平台或工具中可能提供额外扩展，但核心语法保持相对稳定。
实际使用中，可通过 Typora、Visual Studio Code、Obsidian 等工具编辑与预览，选择合适的工具有助于提升写作效率，尤其是在长文档编写与版本控制场景中。
标题
使用 # 创建 标题，# 的数量表示标题层级，共支持六级标题，用于组织文档结构。
1
2
3
4
5
6
| # 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
|
Hugo 会自动为标题生成 锚点（ID），可用于页面内跳转。
1
2
3
| ## 我的项目简介
[跳转到上面](#我的项目简介)
|
段落
相邻文本块之间插入一个空行，即可形成新的 段落，用于组织连续文本内容。
在同一段落中 换行，可在行尾添加两个空格，或使用 <br> 强制换行。
1
2
3
| 这一行末尾加两个空格 ␣␣
这是同一段中的新一行。
也可以使用 <br> 强制换行。
|
分隔线
分割线 使用三个或以上的 -、* 或 _，并单独成行，用于在内容之间添加视觉上的区隔。
文本样式
粗体 使用两个星号 ** 或两个下划线 __ 包裹文本，用于强调重点内容。
斜体 使用一个星号 * 或一个下划线 _ 包裹文本，常用于语气或专有名词。
删除线 使用双波浪线 ~~ 包裹文本，表示内容已失效或被删除。
高亮 用于突出显示重点内容，属于扩展语法或 HTML 能力。
1
| ==高亮== → <mark>重要内容</mark>
|
上标与下标 常用于数学或化学表达，可通过扩展语法或 HTML 实现。
1
2
| x^2^ → x<sup>2</sup>
H~2~O → H<sub>2</sub>O
|
Emoji 表情 可通过短代码或 Unicode 字符插入，用于增强表达效果。
1
2
3
| :smile: → 显示为 😄
:rocket: → 显示为 🚀
:heart: → 显示为 ⚠️
|
引用
引用块 使用 > 标记，可包含多段文本或其他 Markdown 元素，用于展示引用内容或强调说明。
1
2
3
| > 这是一个引用。
>
> 可以包含多段文字。
|
在引用中继续使用 >，可形成 多层嵌套。
在部分编辑器或主题中，引用语法可扩展为提示或 警告框。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| > [!NOTE]
> 重要信息提示。
> [!TIP]
> 可选信息或建议。
> [!IMPORTANT]
> 关键内容。
> [!WARNING]
> 潜在风险提示。
> [!CAUTION]
> 警示或负面后果。
|
列表
无序列表 使用 -、* 或 + 作为列表标记，表示没有先后顺序的项目。
1
2
3
| - 项目 A
- 项目 B
- 项目 C
|
有序列表 使用数字加英文句点表示，适合表示步骤或流程。
1
2
3
| 1. 步骤一
2. 步骤二
3. 步骤三
|
通过缩进子项（Tab），可以在列表中表示层级关系，生成 嵌套列表。
1
2
3
4
5
6
| 1. 阶段一
- 任务 A
- 任务 B
2. 阶段二
- 任务 C
- 任务 D
|
任务列表 使用方括号表示完成状态，常用于待办事项。
代码
行内代码 使用反引号 ` 包裹，适合表示命令、变量名或函数名。
1
| 使用 `git status` 查看当前状态。
|
块级代码 使用三个 ` 创建，可在起始反引号后指定语言以启用语法高亮。
1
2
3
4
| ```python
def hello():
print("Hello, World!")
```
|
表格
表格使用竖线 | 分隔列，短横线 - 定义表头分隔行，用于结构化展示数据或进行内容对比。
1
2
3
4
| | 左对齐 | 居中 | 右对齐 |
| :----- | :----: | -----: |
| 内容 A | 内容 B | 内容 C |
| 数据 1 | 数据 2 | 数据 3 |
|
链接
行内链接 通过方括号包裹文字，圆括号中写入链接地址。
1
| [AriaNote](https://www.arianote.top/)
|
引用式链接 将链接地址集中定义，便于在文档中多次复用。
1
2
3
| 参考 [示例网站][example] 获取更多信息。
[example]: https://example.com/
|
自动链接 使用尖括号包裹网址或邮箱地址，直接生成可点击链接。
1
2
| <https://example.com>
<user@example.com>
|
图片
图片使用 ![]() 插入，语法与链接类似，用于展示图形、示意图或截图。
1
2
| 
|
在图片地址后添加引号中的文字，可生成 带标题的图片。
1
| 
|
使用 HTML 标签 可控制图片大小与对齐方式。
1
| <img src="./images/example.png" alt="示例图片" width="60%" align="center">
|
图片也可作为 超链接 使用。
1
| [](https://example.com/)
|
目录
目录 用于根据文档标题结构自动生成导航，在支持 Shortcode 的环境中可插入目录语法。
脚注
脚注 用于在正文中标注补充说明或引用信息，一般通过脚注标记与脚注定义配合使用。
1
2
3
| 这是正文内容。[^1]
[^1]: 这是脚注内容
|
公式
行内公式 使用单个 $ 包裹，用于在正文中插入简短公式。
块级公式 使用 $$ 包裹，需单独成行，适合展示较复杂的数学表达式。
1
2
3
| $$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$
|
流程图
流程图使用 mermaid 代码块，并以 graph 或 flowchart 声明开始。
1
2
3
4
5
6
7
| ```mermaid
graph TD
A[开始] --> B[处理]
B --> C{条件?}
C -->|是| D[输出]
C -->|否| E[结束]
```
|
转义字符
在特殊字符前添加 反斜杠，可取消其 Markdown 语法含义，原样显示具有特殊语法含义的符号。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| \* → 显示为 \*
\_ → 显示为 \_
\# → 显示为 #
\+ → 显示为 +
\- → 显示为 -
\= → 显示为 =
\. → 显示为 .
\! → 显示为 !
\[ → 显示为 [
\] → 显示为 ]
\( → 显示为 (
\) → 显示为 )
\{ → 显示为 {
\} → 显示为 }
\| → 显示为 |
\< → 显示为 <
\> → 显示为 >
\` → 显示为 `
|
使用 HTML 字符实体 可显示 HTML 保留字符。
1
2
3
4
5
6
| < → 显示为 <
> → 显示为 >
& → 显示为 &
" → 显示为 "
' → 显示为 '
→ 显示为空格
|
注释 用于书写说明性内容，不会在渲染结果中显示。
1
2
3
| <!-- 这是一个注释 -->
[//]: # (这是注释)
|
内嵌标签
当 Markdown 无法满足需求时，可直接使用 HTML 标签，HTML 会被原样渲染。
1
2
3
4
5
6
7
8
9
| <p> → 段落
<br> → 换行
<hr> → 分隔线
<strong> → 加粗
<em> → 斜体
<code> → 行内代码
<pre> → 预格式文本
<mark> → 高亮标记
<kbd> → 键盘输入
|
Aria
