Markdown 笔记

经过一番比较,最后还是决定博客用Hexo来建,好看又好用。由于Hexo发表博客使用的是Markdown语法,所以,为了熟悉一下Markdown,博客的第一篇文章就来写它的学习笔记吧。

标题

标题有SettextAtx两种写法。个人比较倾向于Atx,因为写法简单,种类多一点。
Settext的标题只有两种级别,写法是一排=的上一行为一级标题,一排-的上一行是二级标题。 本小节的标题就是用Settext格式来写的。需要注意的是写完下面要空一行。代码如下:

1
2
3
4
5
一号标题 对应 <h1>
=====================
二号标题 对应 <h2>
---------------------

Atx的标题用#来表示,共有六个等级。用几个#就是几级标题。需要注意的是,#的后面要空一格再写文字,否则无效。写法如下:

1
2
3
4
# 一号标题 <h1>
## 二号标题 <h2>
### 三级标题 <h3>
###### 六级标题 <h6>

块注释

通过在文字开头添加>表示块注释。当>和文字之间添加5个空格时,块注释的文字会有变化。
示例:

这是一个注释

这是一个加了五个空格的注释
这是一个加了五个空格的注释
1
2
3
4
>这是一个注释
> 这是一个加了五个空格的注释
> 这是一个加了五个空格的注释

文字格式(斜体与粗体)

将需要设置为斜体的文字放在2个*或者2个_中:

1
2
*斜体*
_斜体_

将需要设置为粗体的文字放在4个*或者4个_中:

1
2
**粗体**
__粗体__

列表(无序与有序)

无序列表使用*+-,并在符号后加空格,三者显示效果相同。建议文件中统一使用一种:

  • 列表1
1
2
* 列表1
* 列表2

有序列表使用数字加.(英文句号)表示,并在后面加空格:

  1. 列表1
  2. 列表2
1
2
1. 列表1
2. 列表2

链接

这是本文的链接[]中为链接显示的文字,()中为链接地址。写法如下:

1
[本文的链接](/2016/04/04/markdown笔记/)

图片

Markdown图片

1
![alt text](/your-path/img.jpg "title")

引用代码

引用代码有3中模式。
第一种,引用keyword,将关键字放在2个反引号中:

1
`keyword`

第二种,多行无行号引用(不可以引用Markdown自己的代码),在代码前添加一个Tab或者4个space。代码如下:

1
2
3
[4个空格]<blockquote>
[4个空格]<p>For example.</p>
[4个空格]</blockquote>

效果如下:

<blockquote>
<p>For example.</p>
</blockquote>

第三种,多行带行号引用,并可以标记语言类别(不可以引用Markdown多行引用,因此请自行替换代码中的'` ):

1
2
3
4
```python
str = 'hello world!'
print str
'''

分割线

在新的一行中使用3个_,效果如下:


HTML标签

Markdown还可以直接支持HTML标签,这样可以有很多自定义写法。 比如上文的图片我无法控制大小和居中,因此可以用标签直接写出来:
Markdown图片

1
<img style="width:200px;margin:auto" src="/images/markdown.jpg" alt="Markdown图片">


More info: Markdown