MarkDown使用技巧
夏日的雨,忽而猛如野兽,忽而柔似少女;
生活难免挫折和磨难,但也有诗和远方。
简介
- MarkDown是一种轻量级标记语言
- MarkDown语言在2004年有约翰·格鲁伯(Jone Gruber)创建
- MarkDown编写的文档可以导出HTML、Work、图像、PDF、Epub等多种格式的文档
- MarkDown编写的文档后缀为 .md,.markdown
标题
注: MarkDown 标题可以使用#来标记,一个# + 空格 表示一级标题,以此类推,共分为六级标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落换行
段落的换行有一下两种方式
- 段落尾部使用两个空格+回车
- 在段落尾部加个空行
字体
MarkDown可以使用一下几种字体
- 斜体文字
- *斜体文字*
- _斜体文字_
- 粗体
- **粗体文字**
- __粗体文字__
- 粗斜体
- ***粗斜体文字***
- ___粗斜体文字___
分割线
分割线可以使用三个或三个以上的 *、-、_ 来表示,中间可以有空格(空格不能在前两个符号之间),但是不能有其他东西
***
—
___
删除线
在文字两端添加两个波浪线~~即可表示删除线
这是删除线
下划线
下划线可以使用HTML的标签来实现,即在文字两端添加标签,示例如下
来个下划线
脚注
脚注是对文本的补充说明
MarkDown创建脚注的格式如下:
[^要注明的文本]
[^要注明的文本]:脚注内容
示例如下:
创建一个1的脚注
列表
-
无序列表
无序列表使用 *、+、- 来表示,符号后面要加空格,示例如下
- 这是无序列表
-
有序列表
有序列表使用 数字 + . + 空格,示例如下
- 这是有序列表
-
列表嵌套
列表嵌套只需要在子列表的行首添加四个空格即可,示例如下
- 这是父列表
- 这是子列表
- 这是父列表
区块
MarkDown区块使用 > + 空格 来表示
MarkDown区块是可以嵌套的,一个 > 表示最外层,两个 > 表示第二层区块,以此类推
MarkDown区块可以和列表搭配使用,语法不变
MarkDown 代码
-
代码片段
如果是段落中的一个函数或者代码片段,可以使用反引号 ` 把它括起来,示例如下:
这是一个函数
print()
,用来打印信息 -
代码块
可以使用三个反引号```来包裹一段代码,并指定一种语言,也可以不指定,示例如下:
```java
代码块
```
public class void main(string[] args){ ...... }
MarkDown 链接
-
普通链接
普通链接的使用方式有以下两种,打开链接可以使用 Ctrl + 鼠标左键:
-
[链接名称](链接地址),示例如下
-
<链接地址>,示例如下
-
-
高级链接
链接也可以使用变量来代替,文档末尾需要给变量赋值,示例如下:
这是[百度]var1,var1表示百度的变量,需要在文档末尾赋值
这是[淘宝]var2,var2表示淘宝的变量,需要在文档末尾赋值
…
[var1]:https://www.baidu.com
[var2]:https://www.taobao.com
展示效果如下:
这是百度,var1表示百度的变量,需要给变量赋值
这是淘宝,var2表示淘宝的变量,需要给变量赋值
…
MarkDown 图片
-
普通使用方法
MarkDown 图片语法格式如下:
![alt 属性文本](图片地址 “可选标题”)
-
可以像网址那样使用变量
语法格式如下:
这是[xxx][var3]的图标
…
[var3]:(http://static.xxx.com/images/xxx.png)
-
MarkDown目前还不能指定图片的高度和宽度,可以通过标签来实现
使用格式如下:
<img src=“http://static.aaa.com/images/aaa.png” width=“50%”>
MarkDown 表格
MarkDown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行,
设置表格对齐方式:
- -: 设置内容和标题栏居右对齐
- :- 设置内容和标题栏居左对齐
- :-: 设置内容和标题栏居中对齐
语法格式示例:
| 左对齐 | 右对齐 | 居中 | | :-------- | --------: | :-----: | | 单元格 | 单元格 | 单元格 | | 单元格 | 单元格 | 单元格 |
展示效果如下:
左对齐 右对齐 居中 单元格 单元格 单元格 单元格 单元格 单元格
MarkDown 高级技巧
支持HTML元素
MarkDown无法表现的样式,都可以直接在文档中使用HTML撰写
目前支持的 HTML 元素有:<kbd>、<b>、<i>、<em>、<sup>、<sub>、<br>等等,示例如下:
重启电脑快捷键:<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
输出结果为:
重启电脑快捷键:Ctrl+Alt+Del
转义
如果需要表现特殊符号,则需要使用反斜杠\转义特殊字符,示例如下:
**加粗**
\* \* 加粗\* \* //正常显示*号
MarkDown支持以下特殊符号使用反斜杠转义:
- \ 反斜杠
- ` 反引号
- * 星号
- _ 下划线
- {} 花括号
- [] 方括号
- () 小括号
- # 井字号
- + 加号
- - 减号
- . 英文句点
- ! 感叹号
hello world ↩︎