Markdown入门指南
官方Markdown语法说明
Markdown语法说明中文版
标题
使用 # 定义标题,# 的数量代表标题阶数;建议在#号后加一个空格,这是标准的 Markdown 语法。
# 一级标题
## 二级标题
### 三级标题
强调
使用”*”或”_”强调字词
粗体
**string**
__string__
string
string
斜体
*str*
_str_
str
str
引用
在引用的文本前加上引用符号”>”;也可嵌套,根据需要加上不同数量的”>”。在引用内可以使用其他的Markdown语法。
> This is a Markdown syntax.
> > *Quote*
This is a Markdown syntax.
Quote
列表
有序列表
有序列表使用数字接着一个英文句点,项目标记后面一定要接着至少一个空格或制表符
1. test
2. administrator
3. root
- test
- administrator
- root
无序列表
无序列表使用星号、加号或是减号作为列表标记
+ admin
* dict
- str
- admin
- dict
- str
代码区块
要在 Markdown 中建立代码区块很简单,只要输入一对“`(键盘左上角~键)就可以。一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
list = ['apple', 'banana', 'orange']
print(list)
代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`)。
This is a `markdown` syntax.
This is a markdown
syntax.
分隔线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西;也可以在星号或是减号中间插入空格。
This is a Dividing line
* * * * * * *
first
-------------
second
_____________
end
链接
行内式链接
[链接文字](http://an.example.com "title")
title文字为可选项
[百度](https://www.baidu.com "百度一下,你就知道")
[新浪](http://www.sina.com.cn "新浪网")
参考式链接
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
[链接文字][辨识链接标识]
接着,在文件的任意处,可以把这个标记的链接内容定义出来:
[辨识链接标识]: https://www.baidu.com "百度一下,你就知道"
链接内容定义的形式为:
- 方括号(前面可以选择性地加上至多三个空格来缩进),里面输入 辨识链接标识
- 接着一个冒号
- 接着一个以上的空格或制表符
- 接着链接的网址
- 选择性地接着 title 内容,可以用单引号、双引号或是括弧包着
[Google][google]
[google]: https://www.google.com "Google"
图片
插入图片的方式和链接相似,也分为行内式和参考式。
行内式
![图片描述](图片地址 "title")
![对比图](https://img-blog.csdn.net/20171014221801164?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvUVNfMTAyNA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)
参考式
[图片描述][辨识符]
[辨识符]: 图片地址 "title"
[python][img]
[img]: https://img-blog.csdn.net/20171014222348848?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvUVNfMTAyNA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来, Markdown 就会自动把它转成链接。
<http://www.baidu.com>
<admin@foxmail.com>
http://www.baidu.com
admin@foxmail.com
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。
*This is a markdown syntax.*
\*This is a markdown syntax.\*
This is a markdown syntax.
*This is a markdown syntax.*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号