Markdown基础语法总结
目录
- 区块元素
- 标题
- 列表
- 区块引用
- 代码区块
- 分隔线
- 段落和换行
- 区段元素
- 链接
- 强调
- 代码
- 图片
- 转义
一、标题
- 类Setext
This is an H1
This is an H2
Code:
This is an H1
====
This is an H2
----
备注:任何数量的=和-都可以有效果<br/>
=表示最高阶标题,-表示第二阶标题
- atx形式
This is an H1
This is an H2
This is an H3
This is an H4
This is an H5
This is an H6
Code:
# This is an H1
## This is an H2
### This is an H3
#### This is an H4
##### This is an H5
###### This is an H6
也可以表示成这样 # This is an H1 #
备注: 行首n个#表示n阶标题，n最大为6
二、列表
- 有序列表
有序列表使用数字接着一个英文句点
- Bird
- McHale
Code:
1. Bird
2. McHale
无序列表
无序列表是使用,+,-中任意一种来表示
- Red
- Green
- Blue
Code:
- Red
+ Green
* Blue
三、引用
区块引用是使用类似email中用>来表示
示例
> 简单引用1
> 简单引用2
>
> 多行引用
>> 嵌套引用
> ## 引用中使用Markdown语法。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
效果
简单引用1 简单引用2
多行引用
嵌套引用
引用中使用Markdown语法。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码：
return shell_exec("echo $input | $markdown_script");
四、代码区块
建立代码区块,只需要简单地缩进4个空格或是1个制表符就可以
代码块一直持续到没有缩进的那一行(或是文件的结尾)
代码块
也可以使用` 来表示
使用缩进表示代码块
五、分隔线
一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西, 也可以在星号或是减号中间插入空格
---
- - -
***
* * *
——————————————
——————————————
六、段落和换行
- 段落
段落是由一个或多个连续的文本行组成,
它的前后要一个以上的空行(显示上看起来像是空的)
- 换行
Mardown允许段落内的强迫换行(插入换行符)
要依赖Markdown来插入<br/>标签的话,在<br/>插入处要先按入两个以上的空格然后回车
七、链接
支持两种形式的连接语法: 行内式和参考式 链接字符不区分大小写
Code:
This is [baidu](http://www.baidu.com/ "度娘")
[baidu](https://www.baidu.com/)
参考式
This is baidu example reference-style link.
Code:
This is [baidu example][id] reference-style link.
标记: [id]: https://www.baidu.com/ "度娘"
或者: [id]: https://www.baidu.com/ '度娘'
或者 [id]: https://www.baidu.com/ (度娘)
- 隐式链接标记功能
[Baidu][] 标记可以这样写: [Baidu]: http://baidu.com
Code:
[Baidu][]
标记可以这样写: [Baidu]: http://baidu.com
- 参考式链接范例:
--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"
(备注: 上述代码在使用时需删掉前面的--)
示例如下:
http://www.baidu.com
八、强调
Markdown使用性星号()和底线(_)作为标记强调字词的符号 两端被一个或包围的单词会被转换成斜体 两端被两个*或包围的单词会被转换成粗体 *或_的两端不能有空白 用什么符号就以什么符号结尾
示例
*斜体*
_斜体_
**粗体**
__粗体__
九、代码
如果要标记一段行内代码,可以用反引号 ` 把它包起来 用多个反引号来开启和结束代码区段
段落代码
包含`反引号
包含 `两个反引号`
<特殊符号&>
示例:
``段落代码``
``包含`反引号``
``包含 `两个反引号` ``
``<特殊符号&>``
十、图片 Markdown使用一种和链接很相似的语法来标记图片 允许两种样式:行内式和参考式
- 行内式的图片语法:
示例
示例
- 参考式语法:
示例:
--![雨夜][xd]
--[xd]:http://imgsrc.baidu.com/image/c0%3Dshijue1%2C0%2C0%2C294%2C40/sign=624edb750633874488c8273f3966b38c/eaf81a4c510fd9f94340d04c2f2dd42a2834a444.jpg "视觉中国"
(备注: 上述代码在使用时需删掉前面的--)
十一、转义
使用反斜杠来插入一些在语法中有其它意义的符号,如* 需要转义的字符:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号