一个 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
①引用与嵌套引用
> 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");
> ## 我是引用区块1
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
空出两行(按两次回车)表示上一个区块结束
> ## 我是引用区块2
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
效果:
我是引用区块1
- 这是第一行列表项。
- 这是第二行列表项。
空出两行(按两次回车)表示上一个区块结束
我是引用区块2
- 这是第一行列表项。
- 这是第二行列表项。
在引用中:
①在引用中:
>
> 空出前一行,本行的行头使用五个空格表示代码块
②不在引用中:
空出前一行,本行的行头使用四个空格表示代码块
③代码区块中,一般的 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”
③链接内容定义的形式为:
下面链接的定义都是相同的:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
链接网址也可以用方括号包起来:
[id]: "Optional Title Here"
也可以把 title 属性放到下一行,也可以加一些缩进,若网址太长的话,这样会比较好看:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
网址定义只有在产生链接的时候用到,并不会直接出现在文件之中。
⑤链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写,因此下面两个链接是一样的:
[link text][a]
[link text][A]
①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](图片网址 '图片描述')
![Alt text](图片网址")
详细叙述如下:
![Alt text](https://img-blog.csdnimg.cn/20190311222506230.jpg 'AI')
②参考式的图片语法则长得像这样:
![Alt text][id]
[id]:https://img-blog.csdnimg.cn/20190311222506230.jpg
自动链接Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。
一般网址的链接文字就和链接地址一样,例如:
http://example.com/
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:
\*literal asterisks\*
*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
参考资料 :
Markdown基本语法
Markdown教程
如何使用MarkDown输入连续的两个区块引用