一、Markdown简介
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。 如 GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。
二、Markdown基本操作
1.标题
使用#号标记,可以表示1-6级标题,随#个数递增。如:
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
注:最后一个#与文字间一定要有一个空格。
显示效果:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
2.换行
markdown换行方式有很多种
- 直接在一句话后面敲两个空格
- 两句话之间加一个空行
- 如果你在编辑的时候,想让一行文字分成几段在显示的时候换行,就在中间加
<br/>
此点是我想在表格里换行时get到的,也很实用,后面讲到表格我会展示。
3.字体
加粗
要加粗的文字左右分别用两个*号包起来
斜体
要倾斜的文字左右分别用一个*号包起来
斜体加粗
要倾斜和加粗的文字左右分别用三个*号包起来
删除线
要加删除线的文字左右分别用两个~~号包起来
下划线
下划线直接用html的u标签即可,不属于Markdown语法了。
示例:
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
<u>HTML的下划线标签一起演示</u>
效果如下:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字这是加删除线的文字
HTML的下划线标签一起演示
4.分割线
markdown中分割线,能是你的文章结构更加清楚
几种分割线的写法:
---
----
***
****
三个或者三个以上的 - 或者 * 都可以。效果如下,可以看到,显示效果是一样的。
5.列表
无序列表
语法:
无序列表用 - + * 任何一种都可以
- 列表内容
+ 列表内容
* 列表内容
注意:- + * 跟内容之间都要有一个空格
效果如下:
- 列表内容
- 列表内容
- 列表内容
有序列表
语法:
数字加点
1. 列表内容
2. 列表内容
3. 列表内容
注意:序号跟内容之间要有空格
效果如下:
- 列表内容
- 列表内容
- 列表内容
列表嵌套
上一级和下一级之间敲三个空格即可
- 一级无序列表内容
1. 二级有序列表内容
2. 二级有序列表内容
3. 二级有序列表内容
效果如下:
一级无序列表内容
- 二级有序列表内容
- 二级有序列表内容
- 二级有序列表内容
6.引用
在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...
貌似可以一直加下去,但没神马卵用
示例:
>这是引用的内容
>>这是引用的内容
>>>>>这是引用的内容
效果如下:
这是引用的内容
这是引用的内容
这是引用的内容
注:在列表中使用区块是同样的道理,这里不再赘述。
三、markdown进阶
1.markdown 插入代码
语法:
单行代码:代码之间分别用一个反引号包起来
`代码内容`
代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行
(```)
代码...
代码...
代码...
(```)
注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。还有一种更简洁的模式,三个反引号也可以不写,只需要每行前面必须有4个空格
示例:
单行代码
`create database hero;`
代码块
(```)
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
(```)
或者
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
注意这里每行前面都有4个空格
效果如下:
单行代码create database hero;
代码块
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
2.markdown插入链接
语法:
[超链接名](超链接地址 "超链接title")
title可加可不加
示例:
[平凡记事本](https://www.pfjsb.com)
效果如下:
平凡记事本
注:Markdown本身语法不支持链接在新页面中打开,根据自己编辑器所在的软件环境可以使用程序做扩展性处理添加,或者直接使用html标签。
3.markdown插入图片
语法:

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
示例:

效果如下:
图片引入还有一种扩展写法:
示例(编号n代表一个数字):
![演示图片][编号n]
...间隔很多内容后...
[编号n]:http://www.pfjsb.com/usr/themes/spimes/images/top-banner-news-winter.jpg
效果如下:
4.markdown表格
每排单元格要用| 分开 表头与内容用 — 分开
语法:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行分割表头和内容。里面的-有一个就行,为了对齐,多加了几个
- 文字默认居左
- 两边加:表示文字居中
- 右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略
示例:
姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟
效果如下:
姓名 | 技能 | 排行 |
---|---|---|
刘备 | 哭 | 大哥 |
关羽 | 打 | 二哥 |
张飞 | 骂 | 三弟 |
5.markdown支持HTML元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
例如:
使用<kbd>ctrl</kbd>+<kbd>alt</kbd>+<kbd>alt</kbd>重启电脑
效果如下:
使用ctrl+alt+alt重启电脑