Markdown语法指南

1、背景

个人比较喜欢用Markdonw写东西，比如写博客随笔，写有道云笔记等，但有的时候会突然忘记某个具体语法怎么写了，如插入图片、插入链接、表格等，那干脆把这个语法简单地总结一下，也方便日后快速查询作为参考使用

2、[标题] 语法：井号 + 空格 + 内容

共有六级标题，一级标题字号最大，只写一个#；从二级到六级#号数量依次递增，字号依次递减，六级标题写六个#。

3、[无序列表] 语法：减号 + 空格 + 内容或加号 + 空格 + 内容或者星号 + 空格 + 内容

4、[有序列表] 语法：数字. + 空格 + 内容

5、[内容高亮] 语法：两个等于号 + 内容 + 两个等于号

6、[斜体] 语法：星号 + 内容 + 星号

7、[粗体] 语法：两个星号 + 内容 + 两个星号

8、[粗斜体] 语法：三个星号 + 内容 + 三个星号

9、[删除线] 语法：两个波浪号 + 内容 + 两个波浪号

10、[分割线] 语法：至少三个短横线

### **11、[引用] 语法：`大于号 + 空格 + 内容`**
- 说明：`引用`的语法可嵌套引用，即`两个大于号 + 空格 +内容`、`三个大于号 + 空格 +内容`或更多嵌套，写法和显示效果如下所示：

出自《圣经》

第一章《创世纪》

【创 1:1】 起初 神创造天地。

【创 1:2】 地是空虚混沌，渊面黑暗； 神的灵运行在水面上。

【创 1:3】 神说：“要有光”，就有了光。

【创 1:4】 神看光是好的，就把光暗分开了。

【创 1:5】 神称光为昼，称暗为夜。有晚上，有早晨，这是头一日。

12、[代码框] 语法：三个反单引号 + 内容 + 三个反单引号

说明：反单引号即电脑键盘英文输入状态下，左上角Esc下面的按键，写法和显示效果如下所示：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

说明：代码高亮支持java javascript json cpp css xml sql php vim http nginx ruby等众多语言，当然也可以不用指明代码语言，此时为禁用代码高亮

13、[插入链接] 语法：左中括号 + 链接说明 + 右中括号 + 左小括号 + 链接地址 + 右小括号

如下所示：

百度首页

另外，由于在页面中嵌套过多链接不美观，修改时也无法集中修改，因此还有一种方式来插入链接，即把链接地址提取出来放到页面最下面（或其它你觉得合适的地方），写法和显示效果如下所示：

百度搜索

雅虎首页

说明1：插入链接的方式中，双引号里的内容是鼠标悬浮标题，可有可无。

说明2：第二种插入链接的方式中，需要在页面底部标注出1 2所引用的链接地址

14、[插入图片] 语法：感叹号 + 左中括号 + 图片说明 + 右中括号 + 左小括号 + 图片链接 + 右小括号

即比链接语法多了一个感叹号，如下所示：

15、[插入表格]语法

插入表格说明：用 | 分隔单元格，用 - 分隔表头和内容行，:---、:--:、---:分别代表左对齐、居中对齐、右对齐（当然也可以不用指明对齐方式，默认是左对齐），如图所示：

显示效果如下：

姓名	性别	院校	专业
LukeFan	男	合工大	计算机

16、[页面内导航]语法：左中括号 + 导航说明 + 右中括号 + 左小括号 + 井号 + 跳转行id + 右小括号

说明：该语法好像描述得有点晦涩 不直观 也不易懂......我们就直接来看看具体写法吧，如下所示，我写了两个页面导航跳转，其中小括号里的jump和desc就是id，可随意命名。

在你想要跳转到的那一行的上面，加入如下圈内代码，是用<h6>标签，还是用<span>标签无所谓，只要指定了id就行

显示效果如下：

跳到[引用]语法处

跳到”1、背景“

17、[首行缩进]语法：两个全角空格 + 内容

• 1.Markdown没有专门的符号来表示首行缩进；

• 2.我们可以先把输入法置为全角状态；

• 3.然后再输入两个空格即可实现缩进

18、[如何换行] 语法：空格 + 空格 + 换行

最后说明：上面分享的Markdown简明语法指南是比较通用的，但也有可能这里的语法对于你在使用的Markdown解析器是不起作用的，这就要看具体的Markdown编辑器了