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. 第三项

效果

  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 可以结束当前会话。

大多数 蝾螈 都是夜行性动物,以昆虫、蠕虫等小生物为食。

Footnotes

  1. 上面这段引用出自 Rob Pike 在 2015 年 11 月 18 日 Gopherfest 上的演讲。 ↩