Markdown 语言学习

Markdown 的目标是实现「易读易写」。

Markdown 语法的目标是:成为一种适用于网络的书写语言。

Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

Markdown 的语法简洁明了、学习容易,而且功能比纯文本更强。

建议使用缩进表示归属上一层级,如果出现块情况非空行不能处理归属问题

标题

1
2
3
4
5
6
H1 :# Header 1
H2 :## Header 2
H3 :### Header 3
H4 :#### Header 4
H5 :##### Header 5
H6 :###### Header 6

H1 :# Header 1
H2 :## Header 2
H3 :### Header 3
H4 :#### Header 4
H5 :##### Header 5
H6 :###### Header 6

文本样式

1
2
3
4
5
6
7
8
9
10
11
12
(带“*”星号的文本样式,在原版 Markdown 标准中不存在,但在其大部分衍生标准中被添加)
链接 :[Title](URL)
加粗 :**Bold**
斜体字 :*Italics*
*删除线 :~~text~~
*高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : `alert('Hello World');`
画水平线 (HR) :--------

链接 :Title
加粗 :Bold
斜体字 :Italics
删除线 :text 高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : alert('Hello World');
画水平线 (HR) :——–

图片

1
![Title](src).

写代码

1
连续3个【`】闭合,闭合部分写入代码

HTML 代码

在 HTML 区块标签间的 Markdown 格式语法将不会被处理。处在 HTML 区块标签间不同,Markdown 语法在 HTML 区段标签间是有效的。

特殊字符自动转换

符号 输入
& &
> >
< &lt;

区块引用 Blockquotes

1
2
3
4
5
6
7
8
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
>
> Back to the first level.

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

Back to the first level.

列表

1
2
3
4
5
无序列表使用星号、加号或是减号作为列表标记
* Red // eq: + Red - Red
* Green
Light
* Blue
  • Red
  • Green
    Light
  • Blue
1
2
3
4
5
6
有序列表则使用数字接着一个英文句点
很重要的一点是,列表标记上使用的数字并不会影响输出的 HTML 结果
为未来考虑,建议保留顺序
1. Bird
2. McHale
3. Parish
  1. Bird
  2. McHale
  3. Parish

如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 <p> 标签包起来

1
2
3
* Bird
* Magic

当然,项目列表很可能会不小心产生,像是下面这样的写法:

1
1986. What a great season.

换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。

1
1986\. What a great season.

表格

1
2
3
4
5
| Tables | Col | Type |
| ------------- |:-------------:| -----:|
| SA_User | Type | int |
| SA_Role | RoleName | char |
| SA_UserRole | UserId | 1 |
Tables Col Type
SA_User Type int
SA_Role RoleName char
SA_UserRole UserId 1

自动链接

1
2
一般网址的链接文字就和链接地址一样
<http://example.com/>

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),可以在星号的前面加上反斜杠:

1
\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

1
2
3
4
5
6
7
8
9
10
11
12
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号