0%

Markdown 常用语法 - for hexo

以hexo为平台,介绍适合于本网站的markdown的常用语法。

首要:markdown支持html各种标签

标题

标题前加1~6个连续的“#”。标题和文字间空格
如:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示为:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

空白行

模拟html用<br>。如:

1
2
3
空白行开始:
<br>
空白行结束

显示为:
空白行开始:


空白行结束

分行线

三个或以上的*-单独占一行。当用-时,需和文字空一行,如:

1
2
3
4
5
6
这里文字行紧跟`---`,因此为二级标题
---
这里文字行后为空白行,再为`---`,因此为分行线

---
***

显示为:
这里文字行紧跟---,因此为二级标题


这里文字行后为空白行,再为---,因此为分行线




代码

  • 局部代码可用英文的`夹住,或html的code标签。如:
    1
    `代码片段1`或<code>代码片段2</code>
    显示为:
    代码片段1代码片段2
  • 大段代码用代码块,格式为:
    – 多个英文字符的`
    – 多个英文字符的~
    – html的pre标签
    **注1:```或~~~后加代码类别可显示高亮,pre无**
    **注2:`或~有代码行号,pre无**
    **注3:注意在代码块内显示代码块标记时的不同情况。**
    如:
    以下为~~~,**内层无需转义,使用```**:
    1
    2
    3
    4
    5
    ```python
    for x in range(10):
    sum + = x
    print(sum)
    ```
    以下为pre,**内层需转义,使用\`\`\`**:
    \`\`\`python
    for x in range(10):
      sum + = x
    print(sum)
    \`\`\`
    
    以上均可显示为(以下为直接用内层```的显示结果,注意颜色高亮):
    1
    2
    3
    for x in range(10):
    sum + = x
    print(sum)

转义字符

某些可输入\保留原始符号。
**注:在代码块中保留时,用pre标签则需转义,用`或~标签无需转义**
如:若要显示```,需输入:

  1. 用```时,**直接输入```,无需转义**:
    1
    \\\
  2. 用~~~时,**无需转义,使用```**:
    1
    \\\
  3. 用pre时,无需转义,使用```,注意此用法与pre内的代码块标记有区别
    \\\
    
  4. 硬转义可查看http://www.w3school.com.cn/tags/html_ref_entities.html
    1
    2
    空格:&#160;
    大于:\&gt;
    显示为:
    空格: 
    大于:>

引用

在一行开头加>记得>和文字之间要空格
可通过加多个>表示多级引用。
可通过空行来结束引用。如:

1
2
3
4
5
6
> 一级引用
>> 二级引用
>>> 三级引用
>> 看看回到二级引用了么?

在一个空行之后的部分自动中断引用

一级引用

二级引用

三级引用
看看回到二级引用了么?

在一个空行之后的部分自动中断引用

强调

斜体:文字两端加星号*或下划线_,或用html的i标签实现
加粗:文字两端加双星号**或双下划线__,或用html的strong标签实现
下划线:用html的u标签实现
删除线:用html的del标签实现,或用双波浪线夹在两边实现
如:

1
2
**这里是加粗**,*这里是斜体*,~~这里是删除线~~
<strong>这里是加粗</strong>,<i>这里是斜体</i>,<u>这里是下划线</u>,<del>这里是删除线</del>

显示为:
这里是加粗这里是斜体这里是删除线
这里是加粗这里是斜体这里是下划线这里是删除线

无序列表

行首加*或+或-,显示效果相同,支持二级无序列表。如:

1
2
3
4
5
* 一级列表均为小圆圈标记
+ 一级列表均为小圆圈标记
- 一级列表均为小圆圈标记
-- 二级列表均为-标记
--- 无法产生三级列表
  • 一级列表均为小圆圈标记
  • 一级列表均为小圆圈标记
  • 一级列表均为小圆圈标记
    • 二级列表均为-标记
  • – 无法产生三级列表

为了避免和加粗以及斜体的类似*标记,在此不推荐使用星号。

有序列表

数字后面跟上.和空格,数字的序号和人为加上的序号无关。如:

1
2
3
1. 第一级
4. 第二级
2. 第二级

仍然显示为:

  1. 第一级
  2. 第二级
  3. 第二级

超链接

原位标记方式:

1
2
3
[文字](链接地址)
----------------
这是一个[百度](http://www.baidu.com/)的链接。

显示为:
这是一个百度的链接。

脚注方式:

1
2
3
4
5
6
7
8
9
[文字][数字或字母编号]

[与上面对应的数字或字母编号]: 链接 "鼠标悬停时显示的文字"
------------------
如:
[baidu][1]或[点这里][a]

[1]: www.baidu.com "百度"
[a]: http://search.yahoo.com/

显示为:
baidu点这里

** title外包围的可以是"或'或()**
** 脚注方式和链接之间有空行**
** 同样的编号在此文档内不能重复**

图片

和超链接类似,分为原位标记方式和脚注方式。
原位标记方式:

1
2
3
![占位文字:无图片时显示](相对或绝对路径或超链接)
如:
![我的头像](http://of35dg2v1.bkt.clouddn.com/image/blog/avatar.jpgqq%E5%A4%B4%E5%83%8F.jpg 'my avatar')

显示为:
我的头像

脚注方式:

1
2
3
4
5
6
7
![占位文字:无图片时显示][数字或字母编号]

[与上面对应的数字或字母编号]: 相对或绝对路径或超链接 "鼠标悬停时显示的文字"
如:
![我的头像][b]

[b]: http://of35dg2v1.bkt.clouddn.com/image/blog/avatar.jpgqq%E5%A4%B4%E5%83%8F.jpg "my avatar"

显示为:
我的头像


列表

用html实现:严格强调层层缩进

1
2
3
4
5
6
7
8
9
10
<table>
<tr>
<td>row 1, cell 1</td>
<td>row 1, cell 2</td>
</tr>
<tr>
<td>row 2, cell 1</td>
<td>row 2, cell 2</td>
</tr>
</table>

显示为:

row 1, cell 1 row 1, cell 2
row 2, cell 1 row 2, cell 2

相关网页

《Markdown 11种基本语法 》:http://www.cnblogs.com/hnrainll/p/3514637.html
《Markdown 语法说明 (简体中文版) 》:http://wowubuntu.com/markdown/#list
《简书:markdown入门指南》:http://www.jianshu.com/p/1e402922ee32/
《hexo你的博客》:http://www.tuicool.com/articles/AfQnQjy/

未完待续

多级有序列表或无序列表
自定义css