Markdown语法指南

时间:2022-10-14 21:45:50

1、背景

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

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

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

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

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

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

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

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

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

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

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

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

Markdown语法指南

出自《圣经》

第一章《创世纪》

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

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

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

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

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

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

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

Markdown语法指南

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、[插入链接] 语法:左中括号 + 链接说明 + 右中括号 + 左小括号 + 链接地址 + 右小括号

如下所示:

Markdown语法指南

百度首页

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

Markdown语法指南

百度搜索

雅虎首页

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

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

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

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

Markdown语法指南

Markdown语法指南

15、[插入表格]语法

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

Markdown语法指南

显示效果如下:

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

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

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

Markdown语法指南

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

Markdown语法指南

显示效果如下:

跳到[引用]语法处

跳到”1、背景“

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

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

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

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

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

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