Markdown 使用文档

MarkDown 简介

Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的 HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

使用 Markdown 的优点

专注你的文字内容而不是排版样式，安心写作
轻松的导出 HTML、PDF 和本身的 .md 文件
纯文本内容，兼容所有的文本编辑器与字处理软件
随时修改你的文章版本，不必像字处理软件生成若干文件版本导致混乱
可读、直观、学习成本低

Markdown 语法的简要规则

标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可。

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。

列表

熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在 Markdown 如下：

无序列表

无序列表的显示只需要在文字前加上 - 或 *

- 无序列表

* 无序列表

有序列表

有序列表的显示则直接在文字前加 1.2.3. 符号要和文字之间加上一个字符的空格。

1. 有序列表

2. 有序列表

引用

如果你需要引用一小段别处的句子，那么就要用引用的格式。

> 引用

只需要在文本前加入 > 这种尖括号（大于号）即可

图片与链接

插入链接与插入图片的语法很像，区别在一个 !号

如果插入的是本地图片，markdown 只需引用本地图片的地址即可显示图片，但是本地图片有一个缺点就是将 markdown 转发给其他人时，本地图片也需要一起转，否则 markdown 引用的地址失效，将无法正确显示图片，这也是为何网上一些博客或文章图片无法显示的原因。

有一个办法可以解决图片显示问题，不过需要使用图床，图床也就是把本地图片上传到网上，然后生成图片的 URL 地址即可，markdown 插入图片时使用这个 URL 地址即可。那么，只要可以上网，任何地址都可以正确显示插入的图片了。网上的图床服务有很，这里推荐 CloudApp 的服务。

下载和安装 JDK

下载地址：https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

以上这张图片就是用使用图床显示出来的，它的 URL 地址如下：

![](https://cdn.jsdelivr.net/gh/binbingg/images/img/20200817233148.png)

粗体与斜体

Markdown 的粗体和斜体也非常简单，用两个 * 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。

例如：这里是**粗体** *这里是斜体*

例如：这里是粗体 这里是斜体

表格

项目 | 价格

-------- | ---

Computer | $1600

Phone | $12

Pipe | $1

可以使用冒号来定义对齐方式：

| 项目 | 价格 | 数量 |

| :-------- | --------:| :--: |

| Computer | 1600 元 | 5 |

| Phone | 12 元 | 12 |

| Pipe | 1 元 | 234 |

这种语法生成的表格如下：

项目	价格
Computer	$1600
Phone	$12
Pipe	$1

可以使用冒号来定义对齐方式：

项目	价格	数量
Computer	1600 元	5
Phone	12 元	12
Pipe	1 元	234

代码框

如果你是个程序猿，需要在文章里优雅的引用代码框，在 Markdown 下实现也非常简单，如下：

//``` （开始三个 `，注意写的时候去掉双斜杠，

  代码

// ```（结束三个`，注意写的时候去掉双斜杠

分割线

分割线的语法只需要另起一行，连续输入三个星号 --- 即可。

小结

到这里，Markdown 的基本语法在日常的使用中基本就没什么大问题了，只要多加练习，配合好用的工具，写起东西来肯定会行云流水。

要熟练使用 Markdown，需要掌握一些常用的快捷键，如下：

加粗 Ctrl + B
斜体 Ctrl + I
引用 Ctrl + Q
插入链接 Ctrl + L
插入代码 Ctrl + K
插入图片 Ctrl + G
提升标题 Ctrl + H
有序列表 Ctrl + O
无序列表 Ctrl + U
横线 Ctrl + R
撤销 Ctrl + Z
重做 Ctrl + Y