简介 Introduction
Markdown 是一种轻量级标记语言,创始人为 John Gruber。它允许开发者使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML 或 HTML 文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
下面是 Markdown 的基本语法。
语法 Syntax
标题 Heading
标题是每篇文章必须的格式,在 Markdown 中,想要添加标题只需要在文字前加#
即可。#
的个数决定了标题的级数,一共六级。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落与换行 Paragraph
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。Markdown 的段落没有特殊的格式,可以直接编写文字。段落的换行是使用两个以上的空格加上回车。
区块引用 Quote
Markdown 标记区块引用是使用类似 Email 中>
的引用方式。只需在每行的前面加上>
:
> 这是一段引用
效果:
这是一段引用
此外,区块引用可以嵌套,只要根据层级加上不同数量的>
。
> 最外层
>> 第一层嵌套
>>> 第二层嵌套
效果:
最外层
第一层嵌套
第二层嵌套
列表 List
类似于 HTML,Markdown 支持有序列表和无序列表。列表允许嵌套。
无序列表使用*
、+
、-
作为列表标记:
* HTML
* CSS
* JavaScript
等同于:
+ HTML
+ CSS
+ JavaScript
也等同于:
- HTML
- CSS
- JavaScript
效果:
- HTML
- CSS
- JavaScript
有序列表使用数字后接一个英文句点:
1. Red
2. Blue
3. Green
效果:
- Red
- Blue
- Green
值得注意的是,有序列表中列表标记的数字并不会决定输出结果的顺序。例如:
3. Red
1. Blue
6. Green
效果:
-
Red
-
Blue
-
Green
分隔线 Separation Line
可以在一行中使用三个以上的*
、-
、_
来建立一个分隔线,行内不能有其他东西。例如:
***
*******
-----------
___________
字体 Font
- 删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~
即可:
~~这段文字加了删除线~~
效果:
这段文字加了删除线
- 斜体
如果要对某段文字增加倾斜效果,在文字的左右分别用一个*
,例如:
*这段文字是斜体*
效果:
这段文字是斜体
- 加粗
如果要对某段文字加粗,在文字的左右分别用两个*
,例如:
**这段文字是粗体**
效果:
这段文字是粗体
- 斜体加粗
斜体和粗体的组合效果,在文字的左右分别用三个*
,例如:
***这段文字是斜体加粗体***
效果:
这段文字是斜体加粗体
代码 Code
如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`):
`System.out.print()`
效果:
System.out.print()
也可以用**```**包裹一段代码,并指定一种语言(也可以不指定):
```javascript
console.log('Hello World');
```
效果:
console.log('Hello World');
超链接 Anchor
Markdown 超链接的语法:
[链接名称](链接地址) 或者 <链接地址>
例如:
[bing](https://www.bing.com) 或者 <https://www.bing.com>
效果: bing 或者 https://www.bing.com
图片 Image
Markdown 使用一种和链接很相似的语法来标记图片:
![图片的替代文字](图片路径)
- 开头一个感叹号!
- 接着一个方括号,里面是图片的替代文字
- 接着是一个普通括号,里面是图片的路径或者地址,最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。
表格 Table
Markdown 使用-
来分隔表头和其它行,用|
来分隔不用的单元格,语法:
|左对齐| 居中 |右对齐|
|:----|:---:|----:|
|单元格|单元格|单元格|
|单元格|单元格|单元格|
表格的对齐方式:
-: 右对齐
:- 左对齐(默认)
:-: 居中
左对齐 | 居中 | 右对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |