0%

Markdown介绍

Markdown是一种轻量级标记语言。使用纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。
常用的Markdow语法有 标题 段落 列表 区块 代码 链接 图片 表格 八种,下边一一介绍。

标题

标题使用 #表示,可表示1-6级标题,一级标题一个#、二级标题2个#、以此直到六级标题6个#,#号标题之间用空格间隔
效果

三级标题

四级标题

五级标题
六级标题

Markdown写法

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落

Markdown语法段落的换行需要两个空格+回车

列表

列表分无语列表和有序列表

1、无序列表使用(*)、(+)、(-)任意一个作为标记均可
效果

  • 第一项
  • 第二项
  • 第三项

Markdown写法

1
2
3
* 第一项
* 第二项
* 第三项

2、有序列表使用数字作为排序标记
效果
1 第一项
2 第二项
3 第三项

Markdown写法

1
2
3
1 第一项
2 第二项
3 第三项

3、标记和内容之间用 空格分开

区块

1、在段落开头使用 > 符号,用空格间隔符号和内容。
效果

区块示例

Markdown写法

1
> 区块示例

2、区块是可以嵌套、在第一个区块下一行使用 两个 > 表示。类推,可以一更多层嵌套。
效果

第一层区块

第二层区块

Markdown写法

1
2
> 第一层区块
>> 第二层区块

代码

  1. 代码块可以使用4个空格或一个制表符(tab键)+ 回车 标明此处开始是代码块。代码块的结束,如果一行是顶格开始、则表示代码块结束。
  2. 也可以使用两组反单引号(`)+回车(每组3个反单引号),在半角下,esc键下方的键可敲出反单引号(`)。第一组反单引号后可以指定代码的语言

效果

1
2
3
public void main(){
System.out.println("输出")
}

Markdown写法

1
2
3
4
5
```java
public void main(){
System.out.println("输出")
}
``` 示例结束

链接

效果
超链接使用[链接名](链接地址)表示 或者 <链接地址>表示
百度 或者 https://www.baidu.com

Markdown写法

1
2
[百度](https://www.baidu.com)
<https://www.baidu.com>

图片

1、图片使用 ![alt属性文本](图片地址 "悬浮显示文本(可省略)")表示
效果
百度alt
百度图标

Markdown写法

1
2
![百度alt](https://www.baidu.com/img/flexible/logo/pc/result.png)
![百度图标](https://baike.baidu.com/favicon.ico "百度悬浮")

Html最终语法结果

1
2
<img src="https://www.baidu.com/img/flexible/logo/pc/result.png" alt="百度alt">
<img src="https://baike.baidu.com/favicon.ico" alt="百度图标" title="百度悬浮">

2、Markdown没有办法指定图片的宽高,如果需要的话,使用hmtl的<img>标签来指定

表格

1、Markdown 使用 | 表示列分割符,使用 - 表示行分隔符
效果
|第一列|第二列|
|-|-|
|一行一列|一行二列|
|二行一列|二行二列|

Markdown写法

1
2
3
4
|第一列|第二列|
|-|-|
|一行一列|一行二列|
|二行一列|二行二列|

2、行分隔符中 使用 -: 表示右对齐,使用 :- 表示左对齐,使用 :-: 表示居中对其
效果
|第一列|第二列|第三列|
|-:|:-|:-:|
|一行一列|一行二列|一行三列|
|二行一列|二行二列|二行三列|

Markdown写法

1
2
3
4
|第一列|第二列|第三列|
|-:|:-|:-:|
|一行一列|一行二列|一行三列|
|二行一列|二行二列|二行三列|

至此,Markdown的基本语法已基本介绍完了。