1.段落
一行文字就是一个段落。
如果要需要另起一段,请在两个段落之间隔一个空行。
2.粗体 、斜体
*这是斜体*
_这也是斜体_
**这是粗体**
***这是粗体+斜体***
3.删除线
~~就像这样~~
4.标题
markdown总支持1~6六级标题,通过在一行之前加上不同数量的井号来表示。
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ###
...
###### 这是 H6 ######
5.引用
通过在行首加上大于号 > 来添加引用格式。
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit.id sem consectetuer libero luctus adipiscing.
也可以嵌套其他格式:
> ## 这是一个标题。
> > 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>> 给出一些例子代码:
6.列表
无序列表使用星号、加号或是减号作为列表标记:
* Red
* Green
* Blue
有序列表则使用数字接着一个英文句点:
1. Bird
2. McHale
3. Parish
7.内联代码
用反引号 ` 来标记内联代码。如果代码的内容中有反引号,请用两个反引号包裹。
8.代码区域
有两种方式标记代码区域:
原生风格是行首缩进4个空格。
这是一个普通段落:
这是一个代码区块
github的风格,代码段的前后用三个反引号独占一行来标记。
```
代码块
```
9.分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面 每种写法都可以建立分隔线:
* * *
***
*****
- - -
10.链接
[an example](http://example.com/)
[an example](http://example.com/ "Optional Title")
会被解释为
<a href='http://example.com/'>an example</a>
<a href='http://example.com/' title="Optional Title">an example</a>
11.图像
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional Title")
会被解释为
<img src='/path/to/img.jpg' alt='Alt text' />
<img src='/path/to/img.jpg' alt='Alt text' title='Optional Title' />
12.转义
markdown支持在以下字符前面插入反斜杠
反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
插入之后,将不再解析这些字符,而是原样输出。
13.表格
表格是github风格独有的语法,但近年来渐渐被大多数编辑器支持。
| Item | Value | Qty |
| :------- | ----: | :---: |
| Computer | $1600 | 5 |
| Phone | $12 | 12 |
| Pipe | $1 | 234 |
会被解释成
<table>
<thead>
<tr>
<th align="left">Item</th>
<th align="right">Value</th>
<th align="center">Qty</th>
</tr>
</thead>
<tbody><tr>
<td align="left">Computer</td>
<td align="right">$1600</td>
<td align="center">5</td>
</tr>
<tr>
<td align="left">Phone</td>
<td align="right">$12</td>
<td align="center">12</td>
</tr>
<tr>
<td align="left">Pipe</td>
<td align="right">$1</td>
<td align="center">234</td>
</tr>
</tbody></table>
要注意第二行的冒号决定了居左居右还是居中,如果你不加冒号,默认是居左的。
另外可以把第一行去掉,做成没有表头的表格,但第二行始终是要有的。
14.内联 HTML
Markdown 的语法简洁,但有其局限性,所以特意保留了内联html这种方式。任何html标签及其内容,都会原样输出到结果中。也就是 说,标签中的星号等作为markdown结构的符号,以及构成html标签和实体的符号,都不会做任何转义。