我用markdown写博客已经有半年之久了吧,但是还是会出现有些你想用的功能很难找,或者你尝试使用它不好使,为了帮助那些和我一样热衷于使用markdown的乘客,我决定自己造一架航班,让我们一起搭乘Markdown航班起飞,可能这不是最贵的航班,也不是最好的航班,但是一定是可以带你前往自己想要去的地方!好吧,本次航班即将起飞,请全体乘客系好安全带,祝您旅途愉快!!!
还是先做一点说明吧:本次航班为长途航班,中途会有停靠站,需要中途下机的乘客,请做好准备!!!
注:本博客所有的markdown语法效果展示,均是基于csdn博客自带的markdown,不同的markdown编辑器可能会有略微的区别。
史上最全的Markdown使用教程(没有之一)(20190115)
文章目录
markdown工具介绍:
Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。
一、markdown常用语法(满足简单的日常使用)
1、标题(语法:#
)
语法
:#
markdown用井号定义文章的标题;用法
:markdown中定义的标题一共有6级标题(一般到三级标题也就够用啦)使用注意
:# 一定要标题文本之间有一个空格或一个以上的空格
使用样例如下:
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
样例效果如下:
2、标题(语法:
)
语法
:#
用法
:使用注意
:
使用样例如下:
样例效果如下:
注意:Markdown使用#、+、*等符号来标记, 符号后面必须跟上 至少1个 空格才有效!虽然有些不用加空格,例如CSDN的Markdown编辑器就不加空格也是可以的,但是为了严格要求自己养成一个好习惯,我们是还是规范一下书写格式。
Markdown的常用语法
1 标题:
用#标记:在标题开头加上1~6个#,依次代表一级标题、二级标题….六级标题(一共就六级标题,其实再深的标题也没有意义,一般也就三级标题吧)
- 语法如下
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
- 效果如下:
2 列表:
Markdown 支持有序列表和无序列表。无序列表使用
-、+和*
作为列表标记:
- Red
- Green
- Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
效果如下:
Red
Green
Blue
有序列表则使用数字加英文句点.来表示:
- Red
- Green
- Blue
效果如下:
Red
Green
Blue
引用
引用以>来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法:
这是一段引用 //在
>
后面有 1 个空格这是引用的代码块形式 //在`>`后面有 5 个空格
代码例子:
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
一级引用
二级引用
三级引用
这是一个四级标题
- 这是第一行列表项
- 这是第二行列表项
效果如下:
这是一段引用
这是引用的代码块形式 //在>
后面有 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
这是一个脚注的例子^1
常用弥补Markdown的Html标签
字体
1
2
字体及字体颜色和大小
字体颜色
效果如下:
字体及字体颜色和大小
字体颜色
换行
1
使用html标签<br/>
换行
效果如下:
使用html标签
换行
文本对齐方式
1
2
3
居左文本
居中文本
居右文本
效果如下:居左文本
居中文本
居右文本
下划线
1
下划线文本
效果如下:
下划线文本
这里是脚注
效果如下: ↩︎