Markdown 风格指南

在 Astro 中用 Markdown 写作时常用的基础语法示例。

这是一份在 Astro 中用 Markdown 写作时常用的基础语法示例。

标题

下面的 <h1><h6> 代表六个层级的标题。<h1> 层级最高,<h6> 层级最低。

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

写作时不必刻意换行,让文字自然流淌即可。一段话可以写得很长,渲染器会自动处理折行与排版;中文与英文之间、与数字之间会自动留出半角空格,使阅读节奏更为舒展。

如果需要在新的一行继续书写,而又不想另起一段,可以在行末加两个空格强制换行。

图片

语法

![替代文本](./图片的/完整/或/相对/路径)

效果

博客占位图

引用

引用块用于呈现来自其他来源的内容,可选地附带出处(置于 footercite 元素中),并可添加注释或缩写等行内改动。

不带出处的引用

语法

> 旧纸上的字,比屏幕上的更耐久。  
> **注意**:引用块内部仍可使用 _Markdown 语法_

效果

旧纸上的字,比屏幕上的更耐久。
注意:引用块内部仍可使用 Markdown 语法

带出处的引用

语法

> 不要通过共享内存来通信,而应通过通信来共享内存。<br>
> — <cite>Rob Pike[^1]</cite>

效果

不要通过共享内存来通信,而应通过通信来共享内存。
Rob Pike1

表格

语法

| 斜体     | 粗体   | 代码   |
| -------- | ------ | ------ |
| _斜体_   | **粗体** | `代码` |

效果

斜体粗体代码
斜体粗体代码

代码块

在新一行使用三个反引号开启代码块,写完片段后再以三个反引号收尾;若需高亮特定语言,在开头的三个反引号后写明语言名,如 htmljavascriptcssmarkdowntypescripttxtbash

语法

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

效果

  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 上的演讲