Markdown是一种通过在文段中添加一些符号来实现不同行文格式效果的语言工具。其优势在于写作时可以帮你专注写作而不是迷失在排版中。
详情可参考:https://mp.weixin.qq.com/s/gtZDFPeQfcKYKK0FCiN4YQ
注意:由于博客园本身可能对markdown语法进行了优化,导致部分内容展示效果和markdown本身语法所展现的效果稍微有所不同
入门的基础语法有这几方面:标题、字体、引用、分割线、图片、超链接、列表、代码、表格。
一、标题
使用#号可表示 1-6 级标题,一级标题对应一个#号,二级标题对应两个#号,以此类推。
注:标准语法一般在#后跟个空格再写文字
示例:
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
效果:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
二、字体
加粗: 文字左右分表用两个*号包起来
斜体: 文字左右分别用一个*号包起来
斜体加粗: 文字左右分别用三个*号包起来
删除线: 文字左右分别用两个~~号包起来
示例:
**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果:
这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是加删除线的文字
要点:可以和其他格式混合使用,常见于简书的粗体标重点
易错点:星号有头无尾(前后一致)
三、引用
在引用的文字前加>即可,引用可以嵌套。
示例:
>这是引用的内容
>>这是引用的内容
效果:
这是引用的内容
这是引用的内容
列表中使用
示例:
* 第一项
> 引用1
> 引用2
* 第二项
效果:
第一项
引用1
引用2第二项
四、分割线
三个或者三个以上的 * 。
示例:
前文
***
后文
效果:
前文
后文
五、图片
![图片alt](图片地址 ''图片title'')
图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
示例:
![风景图]( ''风景图'')
效果:
图片插入(包括网络图片和本地图片)
插入网络图片
用法:! 加 [显示文本] 加 (图片格式的链接地址), 中间无空格(与超链接极为相似,只是在前面多了一个叹号)
要点:
插入图片不需要保存
[显示文本]里可以不输入文本,直接输入[],此时图片下没有下划线和解释说明(可对比前图)
易错点:
中间有空格
符号在中文状态下打出
链接不是图片格式
六、超链接
[超链接名](超链接地址 "超链接title")
title可加可不加
示例:
[博客园](https://www.cnblogs.com/)
效果:
博客园
要点:实用语法,值得拥有
易错点:中间有空格
符号在中文状态下打出
七、列表
支持有序列表和无序列表。
无序列表使用星号(*****)、加号(+)或是减号(-)作为列表标记,效果相同。
示例:
* 第一项
* 第二项
* 第三项
效果:
- 第一项
- 第二项
- 第三项
有序列表使用数字并加上 . 号来表示。
示例:
1. 第一项
2. 第二项
3. 第三项
效果:
- 第一项
- 第二项
- 第三项
列表嵌套
列表嵌套只需在子列表中的选项添加四个空格即可。
示例:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
效果:
第一项:
-
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
第二项:
-
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
八、代码
单行代码:代码之间分别用一个反引号包起来
代码区块:可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定),也可以使用 4 个空格或者一个制表符(Tab 键)
示例:
`printf("hello")`
```python
a = hello world
print(a)
```
效果:
printf("hello")
a = hello world
print(a)
九、表格
制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
对齐方式
- -: 设置内容和标题栏居右对齐。
- :- 设置内容和标题栏居左对齐。
- :-: 设置内容和标题栏居中对齐。
示例:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
效果:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
Markdown是一门比html更简单的标记语言,其主要用于日常写作。最终通过相应的编辑器或者脚本转换成html用于页面渲染。如果你是一个作家,或者是一个程序员,Markdown对你来说是一门必备的技能。