WonderPen 帮助中心

Markdown 语法简介

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前被越来越多的写作爱好者、撰稿者广泛使用。

本文为 Markdown 最常用的语法介绍,旨在提供一个让用户快速上手 Markdown 的说明。

标题

在 Markdown 中,行首以 # 开头的文字被定义为标题,如:

# 标题 1

## 标题 2

### 标题 3

#### 标题 4

##### 标题 5

###### 标题 6

以些类推,标题最多六级。建议在 # 后面添加一个空格。

示例:

标题 1

标题 2

标题 3

标题 4

标题 5
标题 6

列表

Markdown 下,列表的显示只需要在文字前加上 -* 即可变为无序列表,加上 1. 2. 3. 等编号则变为有序列表。同样的,建议在列表符号和正文之间加上一个空格。

无序列表:

- 项目 1
- 项目 2
- 项目 3
示例:
  • 项目 1
  • 项目 2
  • 项目 3

有序列表:

1. 项目 1
2. 项目 2
3. 项目 3
示例:
  1. 项目 1
  2. 项目 2
  3. 项目 3

引用

如果要表示一段文字是引用,只需在它前面加一个大于号 > 。如果你用过早年的 Email 或 BBS,一定对这种语法不陌生。

> 这样表示引用
示例:
这是一段引用。

引用可以包含多行内容:

这是引用内容 1
这是引用内容 2
这是引用内容 3

超链接

要在文档中插入超链接,可以使用以下语法:

[链接文字](链接地址)
示例:

[WonderPen](https://www.tominlab.com/wonderpen) 会被渲染为:WonderPen

图片

插入图片的语法与插入链接的语法类似,区别在于前面多了一个感叹号 !

![妙笔](https://www.tominlab.com/images/wonderpen/logo_icon.png)

粗体与斜体

用两个 * 包含的文本会渲染为粗体,一个 * 包含的文本渲染为斜体。如下:

**粗体**

*斜体*
示例:

**粗体**粗体

*斜体*斜体

表格

表格的语法相对较为复杂,大体上,表格分为表头对齐设置表内容三个部分。比如下面的例子:

|左对齐|居中对齐|右对齐|
|---|:---:|---:|
|AAA|abc|10|
|BBB|33|5|

会被渲染成如下的表格:

左对齐 居中对齐 右对齐
AAA abc 10
BBB 33 5

分割线

如果想在页面插入分割线,可以另起一行,输入三个 *-,如下:

***

---
示例:

*** 会被渲染为:


--- 会被渲染为:


小结

至此,你已经了解了 Markdown 最常用的语法,可以开始使用 Markdown 进行日常写作了。如需进一步了解,可继续阅读更多相关内容。