# markdown快速入门笔记
初学markdown，边做笔记的同时，加以语法实际效果展示，以期加深记忆。
Ⅰ 、区块元素
- 段落和换行
- 标题
- 字体
- 分隔线
- 引用
- 列表
（一）段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。
简而言之：按一次回车表示换行，按两下表示切换段落
一次回车：
>这是一段
>按一次回车
两次回车：
>这是一段
>按两次回车
效果如下
一次回车：
这是一段
按一次回车
两次回车：
这是一段
按两次回车
在之后的演示中，我们还将复习本段知识
（二）标题
①方法一：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 没有7级标题
效果如下：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
####### 没有7级标题
②方法二：
This is an H1
=============
This is an H2
-------------
效果如下：
This is an H1
This is an H2
③方法三：
# 这是 H1 #
## 这是 H2 ##
效果如下：
这是 H1
这是 H2
（三）字体
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果如下：
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字
（四）分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
大字体分隔线a
---
大字体分隔线b
----
小字体分隔线c
***
小字体分隔线d
*****
示例：
大字体分隔线a
大字体分隔线b
小字体分隔线c
小字体分隔线d
（五）引用
(1)普通引用
①引用与嵌套引用
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
②Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >:
> Donec sit amet nisl.
Aliquam semper ipsum sit amet velit.
③引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：
> ## 这是一个标题。
> > 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一个例子代码块(具体使用方法在：本文‘四、引用（3）代码块’的表示中)：
>
> return shell_exec("echo $input | $markdown_script");
效果（本小节效果左侧竖杠为实际语法效果，不为强调目的使用）：
①引用与嵌套引用
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
②Markdown 也允许你偷懒只在整个段落的第一行最前面加上 >:
Donec sit amet nisl.
Aliquam semper ipsum sit amet velit.
③引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一个例子代码块(具体使用方法在：本文三、引用（3）代码块的表示中)：
return shell_exec("echo $input | $markdown_script");
(2)区块引用Blockquotes
> ## 我是引用区块1
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
空出两行(按两次回车)表示上一个区块结束
> ## 我是引用区块2
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
效果：
我是引用区块1
- 这是第一行列表项。
- 这是第二行列表项。
空出两行(按两次回车)表示上一个区块结束
我是引用区块2
- 这是第一行列表项。
- 这是第二行列表项。
（3）代码块的表示
在引用中：
①在引用中：
>
> 空出前一行，本行的行头使用五个空格表示代码块
②不在引用中：
空出前一行，本行的行头使用四个空格表示代码块
③代码区块中，一般的 Markdown 语法不会被转换，像是星号便只是星号
***
---
效果：
①在引用中：
空出前一行，本行的行头使用五个空格表示代码块
②不在引用中：
空出前一行，本行的行头使用四个空格表示代码块
（六）列表
①无序列表使用星号、加号或是减号作为列表标记：
（使用效果相同）
>* Red
>* Green
>* Blue
>
>
>+ Red
>+ Green
>+ Blue
>
>
>- Red
>- Green
>- Blue
②数字-句点-空白
有序列表则使用数字接着一个英文句点,再加上一个以上的空格。
且有自动修正序号的效果，也就是说你在'.'前面随便写数字都可以。
例如:
>1. Bird
>1. McHale
>1. Paris
③列表中的引用（用四个空格或一个Tab键）
1. A list item with a blockquote:
> This is a blockquote
> inside a list item.
效果：
①无序列表使用星号、加号或是减号作为列表标记：
（使用效果相同）
- Red
- Green
- Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
②数字-句点-空白
有序列表则使用数字接着一个英文句点,再加上一个以上的空格。
且有自动修正序号的效果，也就是说你在’.'前面随便写数字都可以。
例如:
- Bird
- McHale
- Paris
③列表中的引用（用四个空格或一个Tab键）
-
A list item with a blockquote:
This is a blockquote
inside a list item.
Ⅱ、区段元素
- 链接
- 强调
- 代码
- 图片
（一）链接
Markdown 支持两种形式的链接语法： ①行内式和②参考式两种形式。
①行内式
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
②参考式
I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
链接名称式
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
效果：
①行内式
This is an example inline link.
This link has no title attribute.
②参考式
I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ “Google”
[2]: http://search.yahoo.com/ “Yahoo Search”
[3]: http://search.msn.com/ “MSN Search”
链接名称式
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][].
[google]: http://google.com/ “Google”
[yahoo]: http://search.yahoo.com/ “Yahoo Search”
[msn]: http://search.msn.com/ “MSN Search”
③链接内容定义的形式为：
- 方括号（前面可加上空格来缩进），里面输入文字
- 接着一个冒号
- 接着一个以上的空格或制表符
- 接着链接的网址选择性地接着 title 内容，可以用单引号、双引号或是括弧包着
下面链接的定义都是相同的：
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
链接网址也可以用方括号包起来：
[id]: <http://example.com/> "Optional Title Here"
也可以把 title 属性放到下一行，也可以加一些缩进，若网址太长的话，这样会比较好看：
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
网址定义只有在产生链接的时候用到，并不会直接出现在文件之中。
⑤链接辨别标签可以有字母、数字、空白和标点符号，但是并不区分大小写，因此下面两个链接是一样的：
[link text][a]
[link text][A]
请注意：有一个已知的问题是 Markdown.pl1.0.1 会忽略单引号包起来的链接 title。
（二）强调
①Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 标签包围，用两个 * 或 _包起来的话，则会被转成 ，例如：
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
效果：
single asterisks
single underscores
double asterisks
double underscores
②强调也可以直接插在文字中间：
un*frigging*believable
un**frigging**believable
效果：
unfriggingbelievable
unfriggingbelievable
但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。
\*this text is surrounded by literal asterisks\*
*this text is surrounded by literal asterisks*
（三）代码
①如果要标记一小段行内代码，你可以用反引号(键盘左上角波浪键)把它包起来(’)，例如：
Use the `printf()` function.
Use the printf() function.
如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：
`` There is a literal backtick ( ` ) here.``
There is a literal backtick ( ` ) here.
A single backtick in a code span: `
A backtick-delimited string in a code span: ` foo `
（四）图片
Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。
①行内式的图片语法看起来像是：
![Alt text](图片网址")
详细叙述如下：
- 一个惊叹号 !接着一个方括号，里面放上图片的替代文字
- 接着一个普通括号，里面放上图片的网址
- 最后还可以用引号包住并加上选择性的 ‘title’ 文字。
效果如下：
②参考式的图片语法则长得像这样：
![Alt text][id]
[id]:https://img-blog.csdnimg.cn/20190311222506230.jpg
效果：
其它
（1）自动链接
自动链接Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接。
一般网址的链接文字就和链接地址一样，例如：
<http://example.com/>
（2）反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
例如：如果你想要用星号加在文字旁边的方式来做出强调效果，你可以在星号的前面加上反斜杠：
\*literal asterisks\*
*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
参考资料 ：