Markdown

作者:Goosequill
6 分钟阅读 761 字

本页展示 Goosequill 中常用的 Markdown 写法,包括标题、段落、图片、引用、表格、代码块、列表和少量 HTML 元素。

标题

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

H1

H2

H3

H4

H5
H6

段落

段落之间需要保留一个空行。这样 Markdown 渲染器会把它们识别为两个独立段落。

普通正文可以包含链接、强调、代码片段和脚注。较长的说明建议拆成多个短段落,方便阅读。

图片

语法

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

效果

blog placeholder

引用块

引用块元素表示从其他来源引用的内容,可选择包含引用来源(必须在 footercite 元素中),以及可选的内联更改,如注释和缩写。

无归属引用

语法

> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
> **注意** 你可以在引用块中使用 _Markdown 语法_

效果

Tiam, ad mint andaepu dandae nostion secatur sequo quae.
注意 你可以在引用块中使用 Markdown 语法

带归属引用

语法

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

效果

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

表格

语法

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

效果

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

代码块

语法

我们可以使用 3 个反引号 ``` 在新行上编写代码片段,并用 3 个反引号关闭,要突出显示特定语言的语法,在第一个 3 个反引号后写一个语言名称,例如 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>

Mermaid 图表

语法

```mermaid
flowchart TD
A[编写 Markdown] --> B[渲染 Mermaid]
B --> C[显示图表]
```

效果

flowchart TD A[编写 Markdown] --> B[渲染 Mermaid] B --> C[显示图表]

列表类型

有序列表

语法

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</mark> 可以标记一段需要强调的文字。

效果

GIF 是一种位图图像格式。

H2O

Xn + Yn = Zn

CTRL + ALT + Delete 结束会话。

使用 mark 可以标记一段需要强调的文字。

Footnotes

  1. 上述引用摘录自 Rob Pike 在 Gopherfest(2015 年 11 月 18 日)上的演讲 2


关系图谱

Loading graph...