markdown实用指南

简介

Markdown是一种轻量级标记语言,让写作者专注于写作而不用关注样式。Markdown的目标是实现「易读易写」

标题

用Markdown书写时,只需要在文本前面加上井号#即可创建一级标题。同理,创建二级标题、三级标题等只需增加#个数即可。Markdown共支持六级标题。

注:#和一级标题之间建议保留一个字符的空格,这是最标准的Markdown写法。

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

列表

在Markdown中,无序列表只需要在文字前面加上 - 或者+或者*就可以了,例如:

1
2
3
- 乔丹
- 科比
- 麦迪

有序列表只需要在文字前面加上1. 2. 3. 就可以了,例如:

1
2
3
1. 湖人
2. 勇士
3. 雷霆

注:-1.和文本之间要保留一个字符的空格。

待办列表:表示类别是否勾选状态(注:[] 前后都要有空格

1
2
- [] 不勾选
- [x] 勾选

显示效果如下:

  • [ ] ​
  • [x] ​

html 待办列表: 因为hexo不支持以上的格式,所以只能采用html来解决。

1
2
<input type="checkbox" checked="checked" onclick="return false;"/> 勾选
<input type="checkbox" disabled="disabled" onclick="return false;"/> 不勾选

点我

点我

链接

在Markdown中,插入链接不需要其他按钮,只需要使用[显示文本](l链接地址)这样的语法即可,例如:

1
[简书](http://www.jianshu.com)

插入图片

插入图片的方法和插入链接很像,只是前面多了一个。例如:

1
![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

引用

在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在Markdown中,只需要在希望引用的文字前面加上>即可,例如

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

注:>和文本之间需要保留一个字符的空格

最终显示的就是:

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

粗体和斜体

Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。例如:

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

最终显示的就是下文,其中「一盏灯」是斜体,「一简书」是粗体:

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

代码引用

需要引用代码时,如果引用的语句只有一段,不分行,可以用`将语句包起来。

如果引用的语句为多行,可以将```置于这段代码的首行和末行。

表格

相关代码:

1
2
3
4
5
| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

显示效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

相关代码:

1
2
3
4
5
dog | bird | cat
----|------|----
foo | foo | foo
bar | bar | bar
baz | baz | baz

显示效果:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

转义字符与特殊字符

有一些字符在Markdown语法中有其它意义,如果想在内容中直接输出这些字符可能会出现 问题。

解决方法是使用反斜杠\ 加载该字符前面进行转义,让Markdown按照这些字符的原本内容进行输出。Markdown支持的转义字符如下。

字符 字符名称 在Markdown中的意义 转义输出方式 输出示例
\ 反斜线 转义 \\ \
``` 反引号 代码框(段) ``` `
* 星号 粗体、斜体、列表、分隔线 \* *
_ 底线 粗体、斜体、列表、分隔线 \_ _
{} 花括号 ? \{} {}
[] 方括号 链接、图片 \[] []
() 括弧 链接、图片 \() ()
# 井字号 标题 \# #
+ 加号 列表、分隔线 \+ +
- 减号 列表、分隔线 \- -
. 英文句点 列表 \. .
! 惊叹号 图片 \! !
$ 美元符号 公式 \$ $

除了以上这些字符外,还有两种更特殊的字符:<&,它们在HTML文件中有特殊的意义,因此连转义字符都无法降服这两货。

如果想输出这两个字符,就需要直接用HTML实体的形式,<对应&lt;&对应&amp;,示例如下:

特殊字符 特殊字符名 直接输出方式 直接输出结果 转义输出方式 转义输出结果 正确输出方式 正确输出结果
< 小于 <happy> \<happy> \ &lt;happy> <happy>
& and &gescc; \&gescc; \⪩ &amp;gescc; &gescc;

注:单个反引号可以通过在两边各自加上双反引号来进行转义。

TODO:

七牛云添加图片

参考:

Markdown 语法介绍-CODING帮助中心

Markdown 教程

献给写作者的Markdown新手指南

Markdown语法笔记

用HTML标签实现Markdown Task List