Luoml's blog

Markdown简明语法

发表于  |    |   分类于   |     |   阅读次数

简介

Markdown是一种轻量级标记语言，目标是实现易读易写。

Markdown关注两件事：

格式化的纯文本语法
将纯文本转换成格式化的HTML

语法

标题

Markdown支持Setext、atx两种标题风格。

Setext

Setext使用下划线（等号[=] 一级标题，破折号[-] 二级标题）

1
2
3
4
一级标题 H1
===
二级标题 H2
---

预览效果：
Setext-style header

atx

atx在行首加1 ~ 6个#符，分别对应H1 ~ H6六种标题

1
2
3
4
5
6
# 一级标题 H1
## 二级标题 H2
### 三级标题 H3
#### 四级标题 H4
##### 五级标题 H5
###### 六级标题 H6

预览效果：
atx-style header

引用

普通引用，在行首加 > 符

1
> 引用内容

预览效果：

引用内容

嵌套引用

1
2
> 引用
> > 嵌套引用

预览效果：

引用

嵌套引用

包括标题、列表、代码块等元素的引用

1
2
3
4
> # 一级标题
> + 列表
> + 列表
>        代码块

预览效果：
blockquote

列表中嵌套引用

1
2
3
+ 无序列表
  > 引用
+ 无序列表

预览效果：

  • 无序列表

    引用

  • 无序列表

列表

无序列表

可使用星号（*）、加号（+）或连字符（-）实现同等效果__

1
2
3
+ 无序列表
+ 无序列表
+ 无序列表

1
2
3
- 无序列表
- 无序列表
- 无序列表
1
2
3
* 无序列表
* 无序列表
* 无序列表

预览效果：

  • 无序列表
  • 无序列表
  • 无序列表

有序列表

1
2
3
1. 有序列表
2. 有序列表
3. 有序列表

预览效果：

  1. 有序列表
  2. 有序列表
  3. 有序列表

代码块

代码块需行首1次缩进或4个空格

预览效果：

2次tab
8个空格

列表中嵌套代码块（需要2次tab或8个空格）

1
2
3
+ 无序列表
        <code block>
+ 无序列表

预览效果：

  • 无序列表
    <code block>
  • 无序列表

水平线

三个或三个以上的星号（*）、连字符

1
2
---
***

链接

Markdown支持inline、reference两种链接风格。

文字链接

写 法 语 法 效 果
inline [luoml](http://luoml.github.io "luoml's blog") luoml
reference [luoml][visit-index]，点击访问Luoml's blog
[visit-index]: http://luoml.github.io "luoml's blog"		 luoml，点击访问Luoml’s blog

图像链接

写 法 语 法 效 果
inline ![帅](Markdown-Syntax/images/sq.png "帅呆了") 帅
reference ![帅][url]
[url]: Markdown-Syntax/images/sq.png "帅呆了"		 帅

自动链接

语 法 效 果
Email <ml_luo@126.com> ml_luo@126.com
URL <http://luoml.github.io> http://luoml.github.io

强调

语 法 效 果
斜体 *斜体* 斜体
斜体 _斜体_ 斜体
粗体 **粗体** 粗体
粗体 __粗体__ 粗体
删除线 ~~删除线~~ 删除线

转义字符(\)

语 法 效 果
反斜杠 \\ \
反引号 \` `
星号 \* *
下划线 \_ _
大括号 \{\} {}
中括号 \[\] []
井号 \# #
加号 \+ +
减号 \- -
英文句号 \. .
感叹号 \! !

特殊符号

语 法 效 果
版权符 &copy; ©

脚注

语 法 效 果
脚注 Markdown中文官网[^A]
[^A]: http://www.markdown.cn/		 Markdown中文官网^A

表格

1
2
3
4
5
|ID |Name |Age |
|---|:---:|---:|
|1  |张三 | 29 |
|2  |李四 | 30 |
|3  |王五 | 35 |
ID Name Age
1 张三 29
2 李四 30
3 王五 35 
1
2
3
---    左对齐
:---:  居中对齐
---:   右对齐
1
2
3
4
5
ID |Name | Age
---|:---:|---:
1  |张三 | 29 
2  |李四 | 30 
3  |王五 | 35
ID Name Age
1 张三 29
2 李四 30
3 王五 35

锚点

  1. 标记要跳转的位置 <span id="anchor">表格</span>
  2. 建立跳转的链接 [转向表格](#anchor)

预览效果：
转向表格

Fork me on GitHub