Markdown语法
简介
Markdown 是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。在 2004 由约翰·格鲁伯(英语:John Gruber)创建。编写的文档后缀为 .md, .markdown。
一、标题
在想要设置为标题的文字前面加 #来表示,一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。
注:标准语法一般在# 后跟个空格再写文字。
示例:
# 这是一级标题
## 这是二级标题
### 这是三级标题
效果:
这是一级标题
这是二级标题
这是三级标题
二、段落
Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车。使用空行来换行。
示例:
段落1
段落2
效果:
段落 1
段落 2
三、字体
加粗
:要加粗的文字左右分别用两个 * 号包起来 斜体
:要倾斜的文字左右分别用一个 * 号包起来 斜体加粗
:要倾斜和加粗的文字左右分别用三个 * 号包起来 删除线
:要加删除线的文字左右分别用两个~~ 号包起来
示例:
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果:
这是加粗的文字
这是倾斜的文字 `
这是斜体加粗的文字 这是加删除线的文字
四、引用
在引用的文字前加 > 即可。引用也可以嵌套,如加两个 >> 三个 >>> 可以一直加下去
示例:
>这是引用的内容
>>这是引用的内容
>>>>>这是引用的内容
效果:
这是引用的内容
这是引用的内容
这是引用的内容
五、分割线
三个或者三个以上的 - 或者 * 都可以。
示例:
---
*****
效果如下:
可以看到,显示效果是一样的。
六、图片
语法:![图片alt](图片地址 ''图片title'')
图片 alt 就是显示在图片下面的文字,相当于对图片内容的解释。
图片 title 是图片的标题,当鼠标移到图片上时显示的内容,title 可加可不加。
示例:
![flower](/usr/uploads/2019/07/2749366889.jpeg "蔷薇花")
效果:
七、超链接
语法:[超链接名](超链接地址 "超链接title")
,title 可加可不加。
示例:
[百度](http://baidu.com)
效果:
百度
八、列表
无序列表
语法:无序列表用 - + * 任何一种都可以,注意:- + * 跟内容之间都要有一个空格
- 列表内容
+ 列表内容
效果:
- 列表内容
- 列表内容
有序列表
语法:数字加点,1. 列表内容 2. 列表内容注意:序号跟内容之间要有空格,数字任填,会自动重新排序
示例:
1. 列表内容
1. 列表内容
效果:
- 列表内容
- 列表内容
列表嵌套
上一级和下一级之间敲三个空格即可
示例:
1. 列表内容
- 列表内容
效果:
列表内容
- 列表内容
九、表格
语法:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行分割表头和内容。有一个就行,为了对齐,多加了几个。
文字默认居左,两边加:表示文字居中,右边加:表示文字居右。注:原生的语法两边都要用 | 包起来。此处省略
示例:
姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟
效果:
姓名 | 技能 | 排行 |
---|---|---|
刘备 | 哭 | 大哥 |
关羽 | 打 | 二哥 |
张飞 | 骂 | 三弟 |
十、代码
单行代码:代码之间分别用一个反引号包起来
\`create database hero;\`
代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行; 或使用 4 个空格或者一个制表符(Tab 键)。
\`\`\`
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
\`\`\`
效果:
单行代码create database hero;
代码块
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
十一、转义
显示 markdown 的专有字符可能需要转义,代码块内的内容不会转义。
示例:
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
效果:
\ 反斜杠
\` 反引号
* 星号
\_ 下划线
{} 大括号
[] 中括号
() 小括号
\# 井号
+ 加号
- 减号
. 英文句号
\! 感叹号