markdown 语法

markdown 语法

注：
markdown是一种规范，有些语法只在特定的解释器中支持，这里只提及一些普遍支持的语法。

一、标题

在想要设置为标题的文字前面加# （有一个空格）来表示
一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

示例：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

二、字体

左右各两个*号 加粗

左右各一个*号 斜体

左右三个*号 斜体加粗

左右两个~号 删除线

三、引用

前面加>，引用可以嵌套，貌似可以一直叠加。

前面有提到不同的解释器对关键字的释义不同，下面就是案例，在博客园中，\>的效果与markdownpad并不相同。。。

这是引用

这也是引用

这还是引用

四、分割线

三个或三个以上的-或*都是可以的。

---

---

五、图片

![图片alt](图片地址 "图片title")  
图片alt就是显示在图片下面的文字，相当于对图片内容的解释。  
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加,单双引号均可

Markdown 无法指定图片的宽高，如果需要的话，可以使用普通的<img> 标签。

六、列表

Markdown 支持有序列表和无序列表。

无序列表
使用星号、加号或是减号作为列表标记：
注意后缀空格，建议使用-

• 无序列表
• 无序列表
• 无序列表

有序列表使用数字加点加空格

1. 有序列表
2. 有序列表
3. 有序列表

列表嵌套
只需要在子列表前加四个空格或tab即可

七、代码区块

建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以了。
需要注意的是：一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。
代码区块中，一般的 Markdown 语法不会被转换。

def func():
	print('aaa')
	if a: b = 4
	else: b = 3

八、段落

Markdown 段落没有特殊的格式，段落内的换行是使用两个以上空格加上回车。
当然也可以在段落后面使用一个空行来表示重新开始一个段落。

九、转义字符

有些字符显示需要转义。转义符为\
需要转义的字符如下：

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

十、注释

脚注[^脚注1]
单行注释：单个反引号`注释内容`

示例： 单行注释

目前好像没有明确的多行注释语法，下面的文字根据不同的解释器可能会被解释为一行文字，也可能解释为多行。

注意：

1. 符号为反引号；
2. 三个反引号最好单独一行，某些解释器可能对此敏感。

sfwesdf 
wefdfs  
sdfwe