Markdown语法

十二月 08, 2018

Markdown

自从搭建了 Hexo 博客之后，发现还有 Markdown 这种写文章的方法，最终整理出了一份学习笔记，记录下来，以便后续查看！

标题

Markdown支持6种级别的标题，对应html标签 h1 ~ h6

# h1
## h2
### h3
#### h4
##### h5
###### h6

h1

h2

h3

h4

h5

h6

段落及区块引用

1	> 这段文字将被高亮显示...

这段文字将被高亮显示…

插入链接或图片

注：引用图片和链接的唯一区别就是在最前方添加一个感叹号。

1
2
3

[点击跳转至百度](http://www.baidu.com)
![](/path/to/img.jpg)
![](/path/to/img.jpg "Optional title")

点击跳转至百度

Optional title

列表

Markdown支持有序列表和无序列表两种形式：

无序列表使用*或+或-标识
有序列表使用数字加.标识

* 黄瓜
* 玉米
* 茄子

+ 黄瓜
+ 玉米
+ 茄子

- 黄瓜
- 玉米
- 茄子

1. 黄瓜
2. 玉米
3. 茄子

注：对于有序列表，Markdown将只关注你的第一个项目的数字编号。

黄瓜
玉米
茄子

黄瓜
玉米
茄子

黄瓜
玉米
茄子

黄瓜
玉米
茄子

如果在单一列表项中包含了多个段落，为了保证渲染正常，*与段落首字母之间必须保留四个空格.

*    段落一

     小段一
*    段落二

     小段二

段落一

小段一
段落二

小段二

如果在列表中加入了区块引用，区域引用标记符也需要缩进4个空格

* 段落一
    > 区块标记一
* 段落二
    > 区块标记二

段落一

区块标记一
段落二

区块标记二

分隔线

有时候，为了排版漂亮，可能会加入分隔线。Markdown加入分隔线非常简单，使用下面任意一种形式都可以

1
2

***
---

强调

有时候，我们希望对某一部分文字进行强调，使用*或_包裹即可。使用单一符号标记的效果是斜体，使用两个符号标记的效果是加粗

*这里是斜体*
_这里是斜体_

**这里是加粗**
__这里是加粗__

这里是斜体
这里是斜体

这里是加粗
这里是加粗

插入代码块

行内代码引用，使用单个反引号进行包裹
这是一段var x = 3行内代码

如果插入一整段代码，需要至少使用两个以上反引号进行包裹，且反引号单独占一行，看效果：

1
2
3

fun (x: Int, y: Int): Int {
  return x + y
}

插入表格

表格是Markdown语法中比较复杂的一个，其语法如下：

1
2
3

表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二

注：用|表示表格纵向边界，表头和表内容用-隔开，并可用:进行对齐设置，两边都有:则表示居中，若不加:则默认左对齐。
详细说明：
----:为右对齐
:----为左对齐
:---:居中对齐
-----默认左对齐

特殊符号处理

Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中，主要有以下几种特殊符号需要处理：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

注：在内容中输入以上特殊符号的时候一定要注意转义，否则将导致内容显示不全，甚至排版混乱。

特殊符号处理删除线

使用~~表示删除线。

1	~~这是一条删除线~~

~~这是一条删除线 ~~

注脚

语法说明：
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。
注意：经测试注脚与注脚之间必须空一行，不然会失效。
使用[1]表示注脚。

这是一个注脚测试[^footer1]
[^footer1]: 这是一个测试，用来阐释注脚。
在HEXO中显示没用，其他的上面又有用，我也不清楚啦

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^Le]:开源笔记平台，支持Markdown和笔记直接发为博文

1. 标题