MarkDown 基本语法

一、MarkDown是什么好东西？

1.认识MarkDown

MarkDown 是一个 Web 上使用的文本到HTML的转换工具，可以通过简单、易读易写的文本格式生成结构化的HTML文档，MarkDown中文教程（教程-MarkDown）上的介绍，读完有点懵。简单理解，MarkDown格式很简单，然后以MarkDown格式书写的文章可以直接以纯文本发布到支持Markdown编辑模式的平台上，省去排版的困扰。

2.MarkDown优点

• 简单直观易学
• 纯文本内容，专心考虑内容，无需困扰排版
• 可以运用在几乎任何有文字的地方

二、有哪些MarkDown的基本语法？

1.标题

MarkDown通过在行首添加1-6个 # 符号+空格来定义1-6级标题（有的网站不加空格也能识别，但是最好加）。

• 书写格式
  # 一级标题
  ## 二级标题
  ### 三级标题
  #### 四级标题
  ##### 五级标题
  ###### 六级标题
  眼花缭乱的#，数数数到眼睛疼

• 解析效果

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

---

在上写这篇博客的时候发现一个很有趣的东西，哈哈，上图

本来想加无序列表的，结果刚打- 上去就把前面的文字变成标题了

在- 后加了文字就正常了

查了一下，是因为可以使用=（高阶标题） 和- （次阶标题）来标记一级和二级标题，任何数量的= 和- 都有效果。

• 书写格式

一级标题
=
二级标题
-

• 解析效果

一级标题

二级标题

---

2. 段落

直接写内容就显示为段落，就是这么简单粗暴。

• 书写格式
  这是一个段落
• 解析效果
  这是一个段落

看起来没有毛线区别

3.插入图片

语法：! [ 图片下方显示的东西，可以随便写什么也可以不写 ] ( 图片的线上地址，可以加标题也可以不加 )。本地图片可以使用图床，具体方法可自行查阅。![]()

• 书写格式

  
  
  

• 解析效果

  
  
  

注：和HTML相同，插入的图片也可以有一个鼠标悬浮在图片上放就显示设置的标题的效果，简单的在图片地址后面加"Title"，Title就是鼠标悬浮显示的标题。

4.插入链接

语法：[ 链接显示文字 ]( 链接地址 "Title" )，Title即鼠标悬浮到此处显示的标题，可加可不加。

• 书写格式
  [](www.jianshu.com "好用")
• 解析效果
  

5.文字效果

加粗

两种方式：两个（*）或者底线（_）作为标记强调字词的符号，将需要加粗的文字包围即可。

斜体

两种方式：一个（*）或者底线（_）作为标记强调字词的符号，将需要倾斜的文字包围即可。

加粗+斜体

两种方式：三个（*）或者底线（_）作为标记强调字词的符号，将需要加粗+倾斜的文字包围即可。

删除线

两个波浪线~~作为标记强调字词的符号，将需要加删除线的文字包围即可。

• 书写格式
  这是一段普通的文字
  **这是一段要加粗的文字**
  __这是另外一段要加粗的文字__
  *这是一段要倾斜的文字*
  _这是另外一段要倾斜的文字_
  ***这是一段要加粗和倾斜的文字***
  ___这是另外一段要加粗和倾斜的文字___
  ~~这是一段要加删除线的文字~~
  * 这是一段要倾斜但是 ** 前后都有空白没有倾斜的文字 *

• 解析效果

这是一段普通的文字
这是一段要加粗的文字
这是另外一段要加粗的文字
这是一段要倾斜的文字
这是另外一段要倾斜的文字
这是一段要加粗和倾斜的文字
这是另外一段要加粗和倾斜的文字
这是一段要加删除线的文字

注：如果*或_或~两边都有空格的话，他们会被当作普通符号。

6.列表

无序列表

- + *加空格，后跟内容。

有序列表

数字加.，序号与内容间要有空格。

• 书写格式
  - 我是一个无序列表
  + 我也是
  * 好巧，我也是
  1.我是第一个有序列表
  2.我是第二个有序列表
  3.我是第三个有序列表

• 解析效果

• 我是一个无序列表

• 我也是

• 好巧，我也是
  1.我是第一个有序列表
  2.我是第二个有序列表
  3.我是第三个有序列表

列表嵌套

上级和下级间敲三个空格即可。

• 书写格式
  - 我是一个无序列表
  + 好巧，我也是
  * 神奇，我也是哦
  1.我是第一个有序列表
  - 我是二级无序列表
  2.我是第二个有序列表
  3.我是第三个有序列表
• 解析效果
• 我是一个无序列表

• 好巧，我也是

• 神奇，我也是哦
  1.我是第一个有序列表

• 我是二级无序列表
  2.我是第二个有序列表
  3.我是第三个有序列表

注：这里只演示了有序列表嵌套一个无序列表的写法，其他的嵌套组合也是有效的，可自行测试。

7.表格

• 书写格式（表头与前面内容隔一行）
  |表头|表头|表头|
  |:-|:--:|---:|
  |内容|内容|内容|

• 解析效果

表头	表头	表头
内容	内容	内容

注：第二行元素分隔表头和内容，其中 - 一个以上即可， : 在左即内容左对齐，在右即内容右对齐，两边都有即居中对齐。

8.引用

• 书写格式
  >这是第一个引用
  >>这个第二个引用
  >>>这是第三个引用
• 解析效果

这是第一个引用

这个第二个引用

这是第三个引用

9. 代码

单行代码

语法：代码左右分别一个 `（反引号，键盘上波浪线下面的符号）包裹代码即可。

• 书写方式

`var a = 1`

• 解析效果

var a = 1

代码块

语法：代码左右两边分别用三个```包裹代码块即可。

• 书写格式

```
var a = 1
var b = 2
```

• 解析效果。

    var a = 1
    var b = 2

代码高亮

在写需要展示的代码时，标明代码的种类，有的浏览器会自动的给代码加一些颜色

• 书写格式
  ```JavaScript
  var a = 1
  var b = 2
  ```

• 解析效果

    var a = 1
    var b = 2

10.分割线

语法：三个或以上 * 或 - 或 _ 可有分割线效果 。

• 书写方式
  ***
  ---
  ___
• 解析效果

---

---

---

注：使用 --- 作为水平分割线时，要在它的前面空一行，防止 --- 被当成标题标记的表示方式。

11.角标

语法：这里的角标内容会被放在文末，点击角标可以实现跳转，点击文末的返回按钮即可返回角标，使用 [^] 来定义脚注。

• 书写格式
  这篇博客是有关MarkDown基本语法的博客[^1] ，希望以后继续加油，多写博客[^2]。
  [^1]:[球丁丁的第一篇学习博客]
  [^2]: [加油加油加油]

• 解析效果
  这篇博客是有关MarkDown基本语法的博客^[1] ，希望以后继续加油，多写博客^[2]。

• 文末截图

  
  
  

  文末显示的内容

12. 其他

反斜杠

有时候我们需要在文章中引用一些符号，为了避免这些符号被当作MarkDown标识符发生不必要的格式转化，可以在符号前加 反斜杠\ 来避免。

• 书写格式
  \# 我不是一级标题
  \- 我不是无序列表
• 解析效果

# 我不是一级标题
- 我不是无序列表
MarkDown 支持以下这些符号前面加上 反斜杠 来帮助插入普通的符号（表格来源）：

符号	含义
\	反斜杠
`	反引号
*	星号
_	底线
{}	大括号
[]	方括号
()	括号
#	警号
+ -	加减号
.	英文句号
!	惊叹号

最后推荐一个小游戏可以练习MarkDown基本语法http://commonmark.cn/help/tutorial/

参考资料

• 饥人谷若愚老师相关课程
• 教程-MarkDown
• 文章《进入Markdown园子》
• 文章《Markdown基本语法》
• 文章《Markdown给你前所未有的方便》

---

1. [球丁丁的第一篇学习博客] ↩

2. [加油加油加油] ↩