
Markdown 语法示例
下面是在 Astro 中写 Markdown 内容时常用的一些基础语法示例。
标题
HTML 里的 <h1>—<h6> 表示六个层级的标题,<h1> 是最高层级,<h6> 是最低层级。
H1
H2
H3
H4
H5
H6
段落
这是一个段落示例,用来演示 Markdown 中段落的基本排版效果。连续的普通文本会组成一段,段与段之间用空行分隔。
写作时不用太在意每行的长度,渲染出来的段落会自动换行、自动留出合适的行距。
图片
语法

效果

引用
引用块用来展示引自其他来源的内容,可以在末尾用 footer 或 cite 标注出处,也可以在引用中做加注、缩写等行内修改。
不带出处的引用
语法
> 这是一段引用文字,用来演示引用块的写法。
> **注意**:引用块里同样可以使用 _Markdown 语法_。
效果
这是一段引用文字,用来演示引用块的写法。 注意:引用块里同样可以使用 Markdown 语法。
带出处的引用
语法
> Don't communicate by sharing memory, share memory by communicating.<br>
> — <cite>Rob Pike[^1]</cite>
效果
Don’t communicate by sharing memory, share memory by communicating.
— Rob Pike1
表格
语法
| 斜体 | 粗体 | 代码 |
| --------- | -------- | ------ |
| _斜体文字_ | **粗体文字** | `code` |
效果
| 斜体 | 粗体 | 代码 |
|---|---|---|
| 斜体文字 | 粗体文字 | code |
代码块
语法
在单独一行写三个反引号 ``` 开始代码块,写完代码后再另起一行用三个反引号结束;在开头三个反引号后面写上语言名称(例如 html、javascript、css、markdown、typescript、txt、bash),就能按该语言高亮显示。
```html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Example HTML5 Document</title>
</head>
<body>
<p>Test</p>
</body>
</html>
```
效果
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Example HTML5 Document</title>
</head>
<body>
<p>Test</p>
</body>
</html>
列表
有序列表
语法
1. 第一项
2. 第二项
3. 第三项
效果
- 第一项
- 第二项
- 第三项
无序列表
语法
- 列表项
- 另一个列表项
- 还有一个列表项
效果
- 列表项
- 另一个列表项
- 还有一个列表项
嵌套列表
语法
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
效果
- 水果
- 苹果
- 橙子
- 香蕉
- 乳制品
- 牛奶
- 奶酪
其他元素 —— abbr、sub、sup、kbd、mark
语法
<abbr title="Graphics Interchange Format">GIF</abbr> 是一种位图图像格式。
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
按 <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd> 可以结束当前会话。
大多数 <mark>蝾螈</mark> 都是夜行性动物,以昆虫、蠕虫等小生物为食。
效果
GIF 是一种位图图像格式。
H2O
Xn + Yn = Zn
按 CTRL + ALT + Delete 可以结束当前会话。
大多数 蝾螈 都是夜行性动物,以昆虫、蠕虫等小生物为食。