Markdown 风格指南
在 Astro 中用 Markdown 写作时常用的基础语法示例。
这是一份在 Astro 中用 Markdown 写作时常用的基础语法示例。
标题
下面的 <h1>—<h6> 代表六个层级的标题。<h1> 层级最高,<h6> 层级最低。
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
段落
写作时不必刻意换行,让文字自然流淌即可。一段话可以写得很长,渲染器会自动处理折行与排版;中文与英文之间、与数字之间会自动留出半角空格,使阅读节奏更为舒展。
如果需要在新的一行继续书写,而又不想另起一段,可以在行末加两个空格强制换行。
图片
语法

效果

引用
引用块用于呈现来自其他来源的内容,可选地附带出处(置于 footer 或 cite 元素中),并可添加注释或缩写等行内改动。
不带出处的引用
语法
> 旧纸上的字,比屏幕上的更耐久。
> **注意**:引用块内部仍可使用 _Markdown 语法_。
效果
旧纸上的字,比屏幕上的更耐久。
注意:引用块内部仍可使用 Markdown 语法。
带出处的引用
语法
> 不要通过共享内存来通信,而应通过通信来共享内存。<br>
> — <cite>Rob Pike[^1]</cite>
效果
不要通过共享内存来通信,而应通过通信来共享内存。
— Rob Pike1
表格
语法
| 斜体 | 粗体 | 代码 |
| -------- | ------ | ------ |
| _斜体_ | **粗体** | `代码` |
效果
| 斜体 | 粗体 | 代码 |
|---|---|---|
| 斜体 | 粗体 | 代码 |
代码块
在新一行使用三个反引号开启代码块,写完片段后再以三个反引号收尾;若需高亮特定语言,在开头的三个反引号后写明语言名,如 html、javascript、css、markdown、typescript、txt、bash。
语法
```html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<title>HTML5 示例文档</title>
</head>
<body>
<p>测试</p>
</body>
</html>
```
效果
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<title>HTML5 示例文档</title>
</head>
<body>
<p>测试</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 结束会话。
大多数蝾螈是夜行动物,以昆虫、蠕虫和其他小生物为食。