Markdown语法很简单

本文首发于：https://qinshijia.github.io/2018/08/13/markdown-introduction/

Markdown简介

Markdown是一种轻量级的标记语言，目标是实现易读易写。

简单的语法规则，漂亮的显示效果，容易读写随意改，是Markdown的特点。使用Markdown写作，能让您专注于内容，不需要浪费大量时间去排版。很多博客、在线笔记等工具都支持Markdown格式的文档，例如GitHub、Stack Overflow、、为知笔记。

下面会介绍常用的Markdown语法。

Markdown语法

标题

Markdown中标题分为六级，在行首以 # 开头并空一格再写标题文字。# 的个数标题的级数，一级标题字体最大，六级标题字体最小。

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

段落

段落没有标记，段落的前后应该有一个以上空行。段落不推荐使用缩进。

链接

链接标记是一个中括号和一个小括号连在一块，中括号内是要链接的文字，小括号是链接地址，例如这样。链接可以是绝对地址，也可以是相对地址。

[百度](https://www.baidu.com/)

图片

插入图片需要先保存好图片，然后再通过引入图片的方式显示。

图片的标记是一个感叹号、中括号和小括号连在一起，中括号里是图片加载不出来时显示的文字，小括号里是图片的链接地址。

下面这张图片的写法是：

![Markdown图标](https://upload-images.jianshu.io/upload_images/13557430-772d6394ecaf885a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

Markdown图标

段内代码

段内代码标记是由两个 ` 符号（键盘上制表符上面，1旁边的按键）组成，两个`中间是要显示的代码，例如这样 Hello world!。

`Hello world!`

代码块

代码块是在开头和结尾都以三个连续的 ` 符号组成，中间为显示的代码。怎么没有行号？那是Markdown解析后前端显示的问题，不是语法的问题。

String text = "Hello world!";
System.out.print(text);

引用

在段落的开头使用 > 符号即可，显示的效果如下：

这是一段引用

> 这是一段引用

无序序列

无序序列在行开头使用 * 或者 - 或者 + 即可。显示效果如下

• 无序序列

• 无序序列

• 无序序列

* 无序序列
- 无序序列
+ 无序序列

有序序列

有序列表则使用数字接着一个英文句点，数字的大小顺序对显示的结果没有影响，显示结果会按照行的顺序重新编号。

1. 有序序列1
2. 有序序列2
3. 有序序列3

1. 有序序列1
1. 有序序列2
1. 有序序列3

表格

表格是用符号 | 标记，在 | 之间的就是表格的内容。第一行是表头，第二行是控制表格显示方式，第三行以后是表格内容。

靠左显示	居中显示	靠右显示
第二行使用符号 :-	第二行使用符号 :-:	第二行使用符号 -:

|靠左显示|居中显示|靠右显示|
|:-|:-:|-:|
|第二行使用符号 :-|第二行使用符号 :-:|第二行使用符号 -:|

强调

强调是在段内的 * 之间插入要强调的文字，一个*是斜体，连续两个 **是加粗，例如 我想倾斜一下， 我想加粗一下。

*我想倾斜一下*
**我想加粗一下**

Markdown工具推荐

Markdown 语法已经足够简单了，使用常用的文本编辑器就能完成写作。随着 Markdown 越来越流行，配套工具也丰富了起来，语法高亮、实时预览、图片粘贴等功能也很吸引人。

这里推荐一款文本编辑器 Atom，它着丰富的插件库，在 Atom 的 File -> settings -> install中搜索相应插件然后安装即可，使用方法在搜索结果界面点进去都有介绍。 Markdown 相关的插件有以下这些：

• markdown-writer：语法高亮
• markdown-scroll-sync：编写的时候按了 Ctrl + Shift + M，之后能同步滚动预览
• markdown-image-assistant：截图之后直接按 Ctrl + V 粘贴

其他工具可以看一下Markdown 在线编辑阅读器及应用收集。

参考文档

Markdown 教程