以hexo为平台,介绍适合于本网站的markdown的常用语法。
首要:markdown支持html各种标签
标题
标题前加1~6个连续的“#”。标题和文字间空格
如:
1 | # 一级标题 |
显示为:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
空白行
模拟html用<br>
。如:
1 | 空白行开始: |
显示为:
空白行开始:
空白行结束
分行线
三个或以上的*
或-
单独占一行。当用-时,需和文字空一行,如:
1 | 这里文字行紧跟`---`,因此为二级标题 |
显示为:
这里文字行紧跟---
,因此为二级标题
这里文字行后为空白行,再为---
,因此为分行线
代码
- 局部代码可用英文的`夹住,或html的
code
标签。如:显示为:1
`代码片段1`或<code>代码片段2</code>
代码片段1
或代码片段2
- 大段代码用代码块,格式为:
– 多个英文字符的`
– 多个英文字符的~
– html的pre
标签
**注1:```或~~~后加代码类别可显示高亮,pre无**
**注2:`或~有代码行号,pre无**
**注3:注意在代码块内显示代码块标记时的不同情况。**
如:
以下为~~~,**内层无需转义,使用```**:以下为pre,**内层需转义,使用\`\`\`**:1
2
3
4
5```python
for x in range(10):
sum + = x
print(sum)
```\`\`\`python for x in range(10): sum + = x print(sum) \`\`\`
以上均可显示为(以下为直接用内层```的显示结果,注意颜色高亮):1
2
3for x in range(10):
sum + = x
print(sum)
转义字符
某些可输入\
保留原始符号。
**注:在代码块中保留时,用pre
标签则需转义,用`或~标签无需转义**
如:若要显示```,需输入:
- 用```时,**直接输入```,无需转义**:
1
\\\
- 用~~~时,**无需转义,使用```**:
1
\\\
- 用pre时,无需转义,使用```,注意此用法与pre内的代码块标记有区别:
\\\
- 硬转义可查看http://www.w3school.com.cn/tags/html_ref_entities.html显示为:
1
2空格: 
大于:\>
空格:
大于:>
引用
在一行开头加>
,记得>
和文字之间要空格。
可通过加多个>
表示多级引用。
可通过空行来结束引用。如:
1 | > 一级引用 |
一级引用
二级引用
三级引用
看看回到二级引用了么?
在一个空行之后的部分自动中断引用
强调
斜体:文字两端加星号*
或下划线_
,或用html的i
标签实现
加粗:文字两端加双星号**
或双下划线__
,或用html的strong
标签实现
下划线:用html的u
标签实现
删除线:用html的del
标签实现,或用双波浪线夹在两边实现
如:
1 | **这里是加粗**,*这里是斜体*,~~这里是删除线~~ |
显示为:
这里是加粗,这里是斜体,这里是删除线
这里是加粗,这里是斜体,这里是下划线,这里是删除线
无序列表
行首加*或+或-,显示效果相同,支持二级无序列表。如:
1 | * 一级列表均为小圆圈标记 |
- 一级列表均为小圆圈标记
- 一级列表均为小圆圈标记
- 一级列表均为小圆圈标记
- 二级列表均为-标记
- – 无法产生三级列表
为了避免和加粗以及斜体的类似*标记,在此不推荐使用星号。
有序列表
数字后面跟上.
和空格,数字的序号和人为加上的序号无关。如:
1 | 1. 第一级 |
仍然显示为:
- 第一级
- 第二级
- 第二级
超链接
原位标记方式:
1 | [文字](链接地址) |
显示为:
这是一个百度的链接。
脚注方式:
1 | [文字][数字或字母编号] |
** title外包围的可以是"或'或()**
** 脚注方式和链接之间有空行**
** 同样的编号在此文档内不能重复**
图片
和超链接类似,分为原位标记方式和脚注方式。
原位标记方式:
1 |  |
显示为:
脚注方式:
1 | ![占位文字:无图片时显示][数字或字母编号] |
显示为:
列表
用html实现:严格强调层层缩进
1 | <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