MarkDown使用技巧

MarkDown使用技巧

夏日的雨，忽而猛如野兽，忽而柔似少女；
生活难免挫折和磨难，但也有诗和远方。

简介

• MarkDown是一种轻量级标记语言
• MarkDown语言在2004年有约翰·格鲁伯（Jone Gruber）创建
• MarkDown编写的文档可以导出HTML、Work、图像、PDF、Epub等多种格式的文档
• MarkDown编写的文档后缀为 .md，.markdown

---

标题

注： MarkDown 标题可以使用#来标记，一个# + 空格 表示一级标题，以此类推，共分为六级标题

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

---

段落换行

段落的换行有一下两种方式

• 段落尾部使用两个空格+回车
• 在段落尾部加个空行

---

字体

MarkDown可以使用一下几种字体

• 斜体文字
  • *斜体文字*
  • _斜体文字_
• 粗体
  • **粗体文字**
  • __粗体文字__
• 粗斜体
  • ***粗斜体文字***
  • ___粗斜体文字___

---

分割线

分割线可以使用三个或三个以上的 *、-、_ 来表示，中间可以有空格(空格不能在前两个符号之间)，但是不能有其他东西

***

---

—

---

___

---

---

删除线

在文字两端添加两个波浪线~~即可表示删除线

这是删除线

---

下划线

下划线可以使用HTML的标签来实现，即在文字两端添加标签，示例如下

来个下划线

---

脚注

脚注是对文本的补充说明

MarkDown创建脚注的格式如下：

[^要注明的文本]

[^要注明的文本]:脚注内容

示例如下：

创建一个¹的脚注

---

列表

1. 无序列表

   无序列表使用 *、+、- 来表示，符号后面要加空格，示例如下

   • 这是无序列表

2. 有序列表

   有序列表使用 数字 + . + 空格，示例如下

   1. 这是有序列表

3. 列表嵌套

   列表嵌套只需要在子列表的行首添加四个空格即可，示例如下

   • 这是父列表
     • 这是子列表

---

区块

1. MarkDown区块使用 > + 空格 来表示

2. MarkDown区块是可以嵌套的，一个 > 表示最外层，两个 > 表示第二层区块，以此类推

3. MarkDown区块可以和列表搭配使用，语法不变

---

MarkDown 代码

1. 代码片段

   如果是段落中的一个函数或者代码片段，可以使用反引号 ` 把它括起来，示例如下：

   这是一个函数print()，用来打印信息

2. 代码块

   可以使用三个反引号```来包裹一段代码，并指定一种语言，也可以不指定，示例如下：

   ```java

   代码块

   ```

   public class void main(string[] args){
       ......
   }
   

---

MarkDown 链接

1. 普通链接

   普通链接的使用方式有以下两种，打开链接可以使用 Ctrl + 鼠标左键：

   1. [链接名称](链接地址)，示例如下

      百度

   2. <链接地址>，示例如下

      https://www.baidu.com

2. 高级链接

   链接也可以使用变量来代替，文档末尾需要给变量赋值，示例如下：

   这是[百度]var1，var1表示百度的变量，需要在文档末尾赋值

   这是[淘宝]var2，var2表示淘宝的变量，需要在文档末尾赋值

   …

   [var1]:https://www.baidu.com

   [var2]:https://www.taobao.com

   展示效果如下：

   这是百度，var1表示百度的变量，需要给变量赋值

   这是淘宝，var2表示淘宝的变量，需要给变量赋值

   …

---

MarkDown 图片

1. 普通使用方法

   MarkDown 图片语法格式如下：

   

2. 可以像网址那样使用变量

   语法格式如下：

   这是[xxx][var3]的图标

   …

   [var3]:(http://static.xxx.com/images/xxx.png)

3. 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支持以下特殊符号使用反斜杠转义：

• \ 反斜杠
• ` 反引号
• * 星号
• _ 下划线
• {} 花括号
• [] 方括号
• () 小括号
• # 井字号
• + 加号
• - 减号
• . 英文句点
• ! 感叹号

---

---

1. hello world ↩︎