10_史上最全的Markdown使用教程（没有之一）（20190115）

我用markdown写博客已经有半年之久了吧，但是还是会出现有些你想用的功能很难找，或者你尝试使用它不好使，为了帮助那些和我一样热衷于使用markdown的乘客，我决定自己造一架航班，让我们一起搭乘Markdown航班起飞，可能这不是最贵的航班，也不是最好的航班，但是一定是可以带你前往自己想要去的地方！好吧，本次航班即将起飞，请全体乘客系好安全带，祝您旅途愉快！！！

---

还是先做一点说明吧：本次航班为长途航班，中途会有停靠站，需要中途下机的乘客，请做好准备！！！

注：本博客所有的markdown语法效果展示，均是基于csdn博客自带的markdown，不同的markdown编辑器可能会有略微的区别。

---

---

markdown工具介绍：

Markdown 是一种轻量级标记语言，它用简洁的语法代替排版，使我们专心于码字。它的目标是实现易读易写，成为一种适用于网络的书写语言。同时，Markdown支持嵌入html标签。

---

一、markdown常用语法（满足简单的日常使用）

1、标题（语法：# ）

• 语法：# markdown用井号定义文章的标题；
• 用法：markdown中定义的标题一共有6级标题（一般到三级标题也就够用啦）
• 使用注意：# 一定要标题文本之间有一个空格或一个以上的空格

使用样例如下：

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

样例效果如下：

2、标题（语法： ）

• 语法：#
• 用法：
• 使用注意：

使用样例如下：

样例效果如下：

注意：Markdown使用#、+、*等符号来标记， 符号后面必须跟上 至少1个 空格才有效！虽然有些不用加空格，例如CSDN的Markdown编辑器就不加空格也是可以的，但是为了严格要求自己养成一个好习惯，我们是还是规范一下书写格式。

Markdown的常用语法

1 标题：

用#标记：在标题开头加上1~6个#，依次代表一级标题、二级标题….六级标题（一共就六级标题，其实再深的标题也没有意义，一般也就三级标题吧）

1. 语法如下

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

2. 效果如下：
   

2 列表：

Markdown 支持有序列表和无序列表。无序列表使用-、+和*作为列表标记：

• Red
• Green
• Blue

• Red
• Green
• Blue

• Red
• Green
• Blue
  效果如下：

Red
Green
Blue
有序列表则使用数字加英文句点.来表示：

1. Red
2. Green
3. Blue
   效果如下：

Red
Green
Blue
引用
引用以>来表示，引用中支持多级引用、标题、列表、代码块、分割线等常规语法。

常见的引用写法：

这是一段引用 //在>后面有 1 个空格

这是引用的代码块形式    //在`>`后面有 5 个空格

代码例子：

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

一级引用

二级引用

三级引用

这是一个四级标题

1. 这是第一行列表项
2. 这是第二行列表项
   效果如下：

这是一段引用

这是引用的代码块形式 //在>后面有 5 个空格
代码例子：

protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
一级引用

二级引用

三级引用

这是一个四级标题
这是第一行列表项
这是第二行列表项
以下是分割线

强调
两个或-代表加粗，一个或-代表斜体，~~代表删除。

加粗文本 或者 加粗文本

斜体文本 或者_斜体文本_

删除文本
效果如下：

加粗文本 或者 加粗文本

斜体文本 或者 斜体文本

删除文本

图片与链接
图片与链接的语法很像，区别在一个 ! 号。二者格式：

图片：[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1csaf2Ge-1646722427633)()]](图片地址)

链接： 链接文本
链接又分为行内式、参考式和 自动链接：

这是行内式链接：ConnorLin’s Blog。

这是参考式链接：ConnorLin’s Blog，其中url为链接标记，可置于文中任意位置。

链接标记格式为：[链接标记文本]: 链接地址 链接title(可忽略)

这是自动链接：直接使用<>括起来http://connorlin.github.io

这是图片：

效果如下：

这是行内式链接：ConnorLin’s Blog。

这是参考式链接：ConnorLin’s Blog，其中url为链接标记，可置于文中任意位置。

这是自动链接：直接使用<>括起来http://connorlin.github.io

这是图片：

代码
代码分为行内代码和代码块。

行内代码使用 代码 标识，可嵌入文字中
代码块使用4个空格或```标识

这里是代码

代码语法高亮在 ```后面加上空格和语言名称即可

//注意语言前面有空格
这里是代码

例如：

这是行内代码onCreate(Bundle savedInstanceState)的例子。

这是代码块和语法高亮：

1
2
3
4
5
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}

效果如下：

这是行内代码onCreate(Bundle savedInstanceState)的例子。

这是代码块和语法高亮：

1
2
3
4
5
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
表格
表格对齐格式

居左：:----
居中：:----:或-----
居右：----:
例子：

标题	标题	标题
居左测试文本	居中测试文本	居右测试文本
居左测试文本1	居中测试文本2	居右测试文本3
居左测试文本11	居中测试文本22	居右测试文本33
居左测试文本111	居中测试文本222	居右测试文本333

效果如下：

标题 标题 标题
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33
居左测试文本111 居中测试文本222 居右测试文本333
分隔线
在一行中用三个以上的*、-、_来建立一个分隔线，行内不能有其他东西。也可以在符号间插入空格。

---

---

---

---

效果均为一条分割线：

换行
在行尾添加两个空格加回车表示换行：

这是一行后面加两个空格 换行
效果如下：

这是一行后面加两个空格
换行

脚注(注解)
使用[^]来定义脚注：

这是一个脚注的例子¹

这是一个脚注的例子^1

常用弥补Markdown的Html标签
字体
1
2
字体及字体颜色和大小
字体颜色
效果如下：

字体及字体颜色和大小
字体颜色
换行
1
使用html标签<br/>
换行
效果如下：

使用html标签

换行

文本对齐方式
1
2
3

居左文本

居中文本

居右文本

效果如下：

居左文本

居中文本

居右文本

下划线
1
下划线文本
效果如下：

下划线文本

---

1. 这里是脚注
   效果如下： ↩︎