# 简介
Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown 支持嵌入 html 标签。
注意:Markdown 使用 #、+、* 等符号来标记, 符号后面必须跟上 至少 1 个 空格才有效!
# 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);
}
一级引用
二级引用
三级引用
这是一个四级标题
这是第一行列表项
这是第二行列表项
以下是分割线
强调
两个或 - 代表加粗,一个或 - 代表斜体,~~ 代表删除。
加粗文本 或者 加粗文本
斜体文本 或者_斜体文本_
删除文本
效果如下:
加粗文本 或者 加粗文本
斜体文本 或者 斜体文本
删除文本
图片与链接
图片与链接的语法很像,区别在一个!号。二者格式:
图片:
链接: 链接文本
链接又分为行内式、参考式和 自动链接:
这是行内式链接:ConnorLin’s Blog。
这是参考式链接:ConnorLin’s Blog,其中 url 为链接标记,可置于文中任意位置。
链接标记格式为:[链接标记文本]: 链接地址 链接 title (可忽略)
这是自动链接:直接使用 <>
括起来 http://connorlin.github.io
这是图片:
# 代码
代码分为行内代码和代码块。
行内代码使用 代码
标识,可嵌入文字中
代码块使用 4 个空格或 ``` 标识
1 | 这里是代码 |
代码语法高亮在 ``` 后面加上空格和语言名称即可
1 | //注意语言前面有空格 |
例如:
这是行内代码 onCreate(Bundle savedInstanceState)
的例子。
这是代码块和语法高亮:
1 | // 注意java前面有空格 |
效果如下:
这是行内代码 onCreate (Bundle savedInstanceState) 的例子。
这是代码块和语法高亮:
// 注意 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]
这是一个脚注的例子 [1]
常用弥补 Markdown 的 Html 标签
字体
1 | <font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font> |
效果如下:
字体及字体颜色和大小
字体颜色
换行
使用 html 标签 <br/>
换行
文本对齐方式
1 | <p align="left">居左文本</p> |
效果如下:
居左文本
居中文本
居右文本
下划线
1 | <u>下划线文本</u> |
效果如下:
下划线文本
这里是脚注
效果如下: ↩︎