markdown

## Markdown语法指南

 

* * *

 

### 标题

 

> *  # 一级标题

>

> *  ## 二级标题

>

> *  ### 三级标题

>

> *  #### 四级标题

>

> *  ##### 五级标题

>

> *  ###### 六级标题

 

_注：标题总共六级，# 和「一级标题」之间建议保留一个字符的空格，这是最标准的 Markdown 写法。_

 

### 列表

 

无序列表：使用星号、加号或是减号作為清单标记

 

> *  item1

> *  item2

> *   item3

 

等同于：

 

> *  item1

> *  item2

> *  item3

 

等同于：

 

> *  item1

> *  item2

> *  item3

 

有序列表：有序清单则使用数字接著一个英文句点，但是序号数字可以随意，只要是数字即可，例如：

 

> 1. item1

> 2. item2

> 3. item3

 

等同于：

 

> 1. item1

> 2. item2

> 3. item3

 

_注：符号和文本之间要保留一个字符的空格。_

 

### 分割线

 

在一行中用三个或以上的星号、减号、下划线来建立一个分隔线，行内不能有其他东西。你也可以在星号中间插入空白。下面每种写法都可以建立分隔线：

 

* * *

 

* * *

 

* * *

 

* * *

 

### 强调

 

Markdown使用星号_和底线_作為标记强调字词的符号，被_或_包围的字词会被转成斜体，用两个*或_包起来的话，则会被转成黑体，例如：

 

**加粗**

**加粗**

_斜体_

_斜体_

**_加粗并斜体_**

**_加粗并斜体_**

**_加粗并斜体_**

 

建议规范：

 

> 1. 加粗:使用 **加粗**，而不是 **加粗**

> 2. 斜体:使用 _斜体_，而不是 _斜体_

> 3. 加粗并斜体:使用 **_粗斜_**，而不是 **_粗斜_** 等

 

### 源代码

 

插入代码的方式有两种：

 

> 1. 在每行代码前加入4个空格或者添加一个制表符（TAB键）

> 2. 在代码两侧添加三个反引号‘```’。

 

*   其缩进是相对于当前格式状态下的。&gt; 列表项&gt; 列表项> [<spanclass="hljs-link_label">TAB</span>][<span class="hljs-link_reference">TAB</span>]printf("helloworld!");

>    `</pre>

 

    _注：在列表项状态下，需要输入两次TAB键(制表符)才能以代码格式插入。_

 

*   反引号最好在代码的前后行添加，而不是直接加在代码两边。

 

    示例:

 

   <pre>`<span class="hljs-tag"><<spanclass="hljs-title">span</span> <spanclass="hljs-attribute">class</span>=<spanclass="hljs-value">"hljs-keyword"</span>></span>public<spanclass="hljs-tag"></<spanclass="hljs-title">span</span>></span> <spanclass="hljs-tag"><<spanclass="hljs-title">span</span> <spanclass="hljs-attribute">class</span>=<span class="hljs-value">"hljs-keyword"</span>></span>class<spanclass="hljs-tag"></<spanclass="hljs-title">span</span>></span> HelloWord{

       <span class="hljs-tag"><<spanclass="hljs-title">span</span> <spanclass="hljs-attribute">class</span>=<span class="hljs-value">"hljs-keyword"</span>></span>public<spanclass="hljs-tag"></<spanclass="hljs-title">span</span>></span> <spanclass="hljs-tag"><<spanclass="hljs-title">span</span> <spanclass="hljs-attribute">class</span>=<spanclass="hljs-value">"hljs-keyword"</span>></span>static<spanclass="hljs-tag"></<spanclass="hljs-title">span</span>></span> <spanclass="hljs-tag"><<span class="hljs-title">span</span><span class="hljs-attribute">class</span>=<spanclass="hljs-value">"hljs-keyword"</span>></span>void<spanclass="hljs-tag"></<spanclass="hljs-title">span</span>></span>main(String[] args){

           Stystem.<span class="hljs-tag"><<spanclass="hljs-title">span</span> <spanclass="hljs-attribute">class</span>=<spanclass="hljs-value">"hljs-keyword"</span>></span>out<spanclass="hljs-tag"></<spanclass="hljs-title">span</span>></span>.println(<spanclass="hljs-tag"><<spanclass="hljs-title">span</span> <spanclass="hljs-attribute">class</span>=<spanclass="hljs-value">"hljs-string"</span>></span>"你好,明天!);

           }

       }

   }<span class="hljs-tag"></<spanclass="hljs-title">span</span>></span>

 

> 段内源代码

> 如果要标记一小段行内源代码，你可以用反引号把它包起来(`)，例如：

 

Use the `printf()` function.

 

### 超链接

 

语法格式：[显示文本标题](链接地址)，被链接的文字用[]包起来，在方块括号后面马上接著圆括号并插入网址链接即可，比如：

 

This is [an example](http://example.com/"Title") inline link.

 

[This link](http://example.net/) has notitle attribute.

 

[百度一下](https://www.baidu.com/)

 

### 图片

 

在 Markdown 中，插入图片不需要其他按钮，你只需要使用  这样的语法即可，例如：


 

> 限制图片大小并居中: 许多 MarkDown 编辑器中直接按原图大小显示图片，造成版面凌乱。如何让图片像简书中那样大小一致居中显示呢？使用该命令&lt;img src="图&gt;片地址" width="图片显示宽度"height="显示高度" alt="图片名称"/&gt;设置图片大小，再用&lt;divalign=center&gt;&lt;/div&gt;命令包裹达到居中效果。

 

示例：

&lt;img src="http://ww4.sinaimg.cn/bmiddle/aa397b7fjw1dzplsgpdw5j.jpg"width="400" height="400" alt="简书"/&gt;

 

或者使用如下语法：``

 

_注：插入图片的语法和链接的语法很像，只是前面多了一个！。_

 

### 添加空行

 

添加空行可以结束先前的格式状态。个人建议在改变格式时，均添加一个空行。

 

### 转义字符

 

用\将特殊字符如*, [, &gt; 变成普通字符

可以转义的有：

 

> \ 反斜杠

>

> ` 反引号

>

> *  星号

>

> _ 下划线

>

> {} 大括号

>

> [] 中括号

>

> () 小括号

>

> # 井号

>

> *  加号

>

> *  减号

>

> . 英文句号

>

> ! 感叹号

 

### 首行缩进

 

写文章时，我们常常希望能够首行缩进，这时可以在段首加入` ` 来输入一个空格.加入 来输入两个空格。

 

  一语未了，只听后院中有人笑声，说：“我来迟了，不曾迎接远客！"

 

### 引用

 

在我们写作的时候经常需要引用他人的文字，这个时候引用这个格式就很有必要了，在 Markdown 中，你只需要在你希望引用的文字前面加上 &gt; 就好了，例如：

 

> 一盏灯，一片昏黄；一简书，一杯淡茶。守着那一份淡定，品读属于自己的寂寞。保持淡定，才能欣赏到最美丽的风景！保持淡定，人生从此不再寂寞。

 

诗词引用:

 

> 朝辞白帝彩云间,

>

> 千里江陵一日还。

>

> 两岸猿声啼不住,

>

> 轻舟已过万重山。

 

_注：&gt; 和文本之间要保留一个字符的空格。_

 

### 表格

 

<table>

<thead>

<tr>

<th>id</th>

<th>username</th>

<th>password</th>

</tr>

</thead>

<tbody>

<tr>

<td>03133035</td>

<td>03133035</td>

<td>123456</td>

</tr>

<tr>

<td>03133035</td>

<td>03133035</td>

<td>123456</td>

</tr>

<tr>

<td>03133035</td>

<td>03133035</td>

<td>123456</td>

</tr>

</tbody>

</table>