简介
Markdown是一种轻量级标记语言,它运行人们使用易读写的纯文本格式编写文档。MarkDown是2004年又约翰·格鲁伯创建的。MarkDown编写的文档可以导出HTML、Word、图像、PDF、Epub等多种格式。
一.标题
规则:文字前面多少“#”代表着多个级标题,最多支持六级标题,下面为各级标题的显示效果
MarkDown中输入如下:
#一级标题
##二级标题
###三级标题
####四级标题
#####五极标题
######六级标题
实际显示效果如下:
一级标题
二级标题
三级标题
四级标题
五极标题
六级标题
二、字体
2.1 斜体
规则:在文字字两边用“*”包起来
MarkDown中输入如下:
*这是斜体*
实际显示效果如下:
这是斜体
2.2 加粗
规则:在文字两边用“**”包起来
MarkDown中输入如下:
**这是粗体**
实际显示效果如下:
这是粗体
2.3 斜体加粗
规则:在文字两边用三个“***”包起来
MarkDown输入如下:
***这是斜体加粗***
实际显示效果如下:
这是斜体加粗
2.4 删除线
规则:在文字两边分别用“~~”包起来
MarkDown输入如下:
~~这是删除线的文字~~
实际显示效果如下:
这是删除线的文字
三、引用
3.1 单级引用
规则:在文字前面加“>”即可
MarkDown输入如下:
>引用
实际显示效果如下
引用
3.2多级引用
规则:在文字前面加多个“>”即可,几级就加几个,貌似可以无限添加,不过意义不大。,下面为二级引用的例子。
MarkDown输入如下:
>>这是多级引用
实际显示效果如下
这是多级引用
四、分割线
规则:在一行使用三个以上的星(*)或者三个减号(-)或者三个下滑线(_)
markdown中输入如下:
***
---
___
实际效果显示如下:
备注:这三种其实是有点差别的,但是在很多markdown平台上显示都是一样。
五、图片
规则:一个感叹号加上中括号,中括号内为图片简介后面是括号,括号内是图片地址
markdown中输入如下:
![沉船湾](https://img.haomeiwen.com/i14400859/7ae0207d195659cb.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
实际显示效果如下:
沉船湾六、超链接
规则:先是一个种括号,中括号内的内容为超链接简介,然后是括号,括号内为超链接地址
markdown输入如下:
[百度](https://www.baidu.com)
[简书](http://jianshu.com)
[知乎](https://www.zhihu.com)
实际显示效果如下:
百度
七、列表
7.1 无序列表
规则:在条目前面加上“-”、“+”、“*”三种中任意一种后,在后面加个空格,再加上条目内容。
markdown上输入如下:
- 条目一
+ 条目二
* 条目三
实际显示效果如下:
- 条目一
- 条目二
- 条目三
备注:条目上部需要与其他内容有个换行,不然会导致无法识别,在条目中换行会自动增加新的条目(部分平台可以简书不可以)
7.2 有序列表
规则:序号加空格加内容
markdown输入如下:
1. 条目一
2. 条目二
3. 条目三
实际显示效果如下:
- 条目一
- 条目二
- 条目三
下面是正常输入的效果
1.条目一
2.条目二
3.条目三
对比可以发现条目离顶部和底部的距离增加了
备注:条目上部需要与其他内容有个换行,不然会导致无法识别。在条目中换行会自动增加新的条目(部分平台上可以,简书不可以)
八、表格
规则:
表头|表头|表头
:-|:-:|-:
内容|内容|内容
内容|内容|内容
说明:表头和内容都使用“|”来分隔,表头只有一行,表头下一行表示当前列的对齐方式,对齐方式有三种
- -: 表示左对齐
- :-: 表示居中
- :- 表示右对齐
markdown输入如下:
表头|表头|表头
:-|:-:|-:
向左对齐|居中|向右对齐
内容|内容|内容
内容|内容|内容
实际显示效果如下:
表头 | 表头 | 表头 |
---|---|---|
向左对齐 | 居中 | 向右对齐 |
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
九、代码
9.1 单行代码
规则:直接在代码前后加上“`”
markdown输入如下:
`System.out.print("Hello Word!");`
实际显示效果如下:
System.out.print("Hello Word!");
备注:实现其他需要高亮
效果的文字也可以使用。
9.2 代码块:
规则:直接在代码上下加上“```“,在第一个“```”后可以指定代码类型
markdown输入如下:
```java
private void print(){
System.out.print("Hellow word!");
}
```
实际显示效果如下:
private void print(){
System.out.print("Hellow word!");
}
备注:还有一种方式是在每一行代码前增加缩进(Tab),也可以实现代码块效果
十、空格和换行
10.1 空格
规则:使用   
三个中的任何一个均可表示空格,但表示的含义不太相同
含义:
 
:表示一个汉字大小
 
:表示一个大写英文大小
:表示一个小写英文大小
markdown中输入如下
 字
汉字
  ABB
AABB
abb
aabb
实际显示效果如下:
字
汉字
ABB
AABB
abb
aabb
备注:markdown只能识别半角状态下的一个空格,多的会没效果,但输入法切换到全角后输入空格均可正常使用,一般切换全角的快捷键是shift+空格。
10.2 换行
规则:使用Html的<br>
标签即可。
markdown输入如下:
这是第一行
<br>
这是第三行
实际显示效果如下:
这是第一行
这是第三行
十一、Html支持
介绍:markdown内联了Html语法,所以可以直接使用Html语法来编写,但目前支持的语法还不是很多,但比较常用的字体大小和字体颜色还是支持的。下面是一个字体颜色和大小的例子:
markdown输入如下
<font color=#0099ff size=12 >黑体</font>
实际显示效果如下:
<font color=#0099ff size=12 >黑体</font>
十二、任务列表
规则:- [ ] 任务名
表示未做任务
- [x] 任务名
表示已做任务
markdown输入如下:
- [ ] 任务一 未做任务
- [x] 任务二 已做任务
实际显示效果如下:
- 任务一 未做任务
- 任务二 已做任务
十三、流程图
由于markdown的流程图是使用代码写的,可能并没有直接画的那么直观,不过这是一个非常不错尝试,markdown是真的能让所有操作都只依赖键盘,这是非常强大的。由于简书等平台并不支持,所以我比较倾向于画图软件,所以这里只简单的说下语法。
规则:
```flow
st=>start: 开始
op=>operation: 操作
cond1=>condition: 条件1
cond2=>condition: 条件2
sub=>subroutine: 子系统
io=>inputoutput: 输入或产出
e=>end: 结束
st->op->cond1
cond1(yes)->cond2
cond1(no)->sub
cond2(no)->io
cond2(yes)->e
```
语法解析:首先最顶部需要添加“```mermaid
flowchat”,然后最底部需要添加“```”,其余中间部分的语法如下:
st=>start: 开始
可以理解为:变量名=>变量类型: 变量值
变量名可以自定义,
变量值为该变量显示的名称
变量类型有六种,分别为
- start:表示开始
- operation:表示操作
- condition:表示条件
- subroutine:表示子程序
- inputoutput:表示输入或输出
- end:表示结束
st->op->cond1
表示连线,这里可以看出是从st变量连接到op变量再连接到cond1变量
cond1(yes)->cond2
由于cond1变量是个条件,所以这里对应着yes的情况
cond1(no)->sub
由于cond1变量是个条件,所以这里对应着no的情况
上面的代码,实现显示如下:
流程图备注:由于简书暂不支持流程图,所以这里只能放一张图片展示效果
网友评论