嘿哟博客

输入关键词搜索文章

↑↓选择

Enter打开

Esc关闭

手记

Markdown 语法指南

这里展示了在 Astro 中编写 Markdown 内容时常用的基础语法示例。

共 1,435 字约 1 分钟
Markdown 语法指南
目录24 节

这里展示了在 Astro 中编写 Markdown 内容时常用的基础语法示例。

标题

以下 HTML <h1>—<h6> 元素代表六个级别的标题。<h1> 级别最高,<h6> 级别最低。

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

这是一段示例文字。在 Markdown 中,段落之间需要空一行分隔。

图片

语法

![图片描述](图片的完整或相对路径)

输出

博客占位图

引用块

引用元素用于表示来自其他来源的内容,可附带出处说明,也支持行内样式。

无出处的引用块

语法

> 这是一段引用的文字。
> 在引用块中也可以使用 **加粗** 或 *斜体* 等 Markdown 语法。

输出

这是一段引用的文字。 在引用块中也可以使用 加粗 或 斜体 等 Markdown 语法。

带出处的引用块

语法

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

输出

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

表格

语法

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

输出

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

代码块

语法

在新行中使用 3 个反引号 ``` 包裹代码片段即可,并在第一个反引号后写明语言名称(如 html、javascript、css、markdown、typescript、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. 第三项

输出

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

评论