Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
推荐使用 Typora 编辑器,它支持 MacOS 、Windows、Linux 平台,且包含多种主题,编辑后直接渲染出效果。附上Typora 官网:https://typora.io/
一、标题
使用#号可表示 1-6 级标题,一级标题对应一个#号,二级标题对应两个#号,以此类推。
注:标准语法一般在#后跟个空格再写文字
示例:
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
效果:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
二、字体
加粗
文字左右分别用两个*号包起来
斜体
文字左右分别用一个*号包起来
斜体加粗
文字左右分别用三个*号包起来
删除线
文字左右分别用两个~~号包起来
示例:
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字这是加删除线的文字
三、引用
在引用的文字前加>即可,引用可以嵌套。
示例:
>这是引用的内容
>>这是引用的内容
效果:
这是引用的内容
这是引用的内容
列表中使用
示例:
* 第一项
> 引用1
> 引用2
* 第二项
效果:
-
第一项
引用1
引用2 -
第二项
四、分割线
三个或者三个以上的 - 或者 * 都可以。
示例:
----
效果:
五、图片
![图片alt](图片地址 ''图片title'')
图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
示例:
![博客园logo](<https://www.cnblogs.com/images/logo_small.gif> ''博客园logo'')
效果:
六、超链接
[超链接名](超链接地址 "超链接title")
title可加可不加
示例:
[百度](http://www.baidu.com)
效果:
七、列表
支持有序列表和无序列表。
无序列表使用星号(*****)、加号(+)或是减号(-)作为列表标记,效果相同。
示例:
* 第一项
* 第二项
* 第三项
效果:
- 第一项
- 第二项
- 第三项
有序列表使用数字并加上 . 号来表示。
示例:
1. 第一项
2. 第二项
3. 第三项
效果:
- 第一项
- 第二项
- 第三项
列表嵌套
列表嵌套只需在子列表中的选项添加四个空格即可。
示例:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
效果:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
八、代码
单行代码:代码之间分别用一个反引号包起来
代码区块:可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定),也可以使用 4 个空格或者一个制表符(Tab 键)
示例:
`printf("hello")`
```python
a = hello world
print(a)
```
效果:
printf("hello")
a = hello world
print(a)
九、表格
制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
对齐方式
- -: 设置内容和标题栏居右对齐。
- :- 设置内容和标题栏居左对齐。
- :-: 设置内容和标题栏居中对齐。
示例:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
效果:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |