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就行
显示效果如下:
17、[首行缩进]语法:两个全角空格 + 内容
1.Markdown没有专门的符号来表示首行缩进;
2.我们可以先把输入法置为全角状态;
3.然后再输入两个空格即可实现缩进
18、[如何换行] 语法:空格 + 空格 + 换行
最后说明:上面分享的Markdown简明语法指南是比较通用的,但也有可能这里的语法对于你在使用的Markdown解析器是不起作用的,这就要看具体的Markdown编辑器了