基本语法
标题
- 在文本前使用 # 表示标题, # 的个数代表标题的级别, # 和文本之间用一个空格隔开。
- 也可以在文本下方使用任意数量的 = 表示一级标题或任意数量的 - 表示二级标题。
段落
用 空白行 分隔段落。
缩进/空格
- & nbsp;:表示一个空格,多个不叠加。
- & ensp;:半角,表示两个空格。
- & emsp;:全角,表示四个空格。
换行
行尾添加 行尾空格 (两个或多个空格),然后回车,表示换行。
强调
- 斜体:在文本两侧使用 * ,和文本之间不要留空格。
- 加粗:在文本两侧使用 ** 。
- 斜体并加粗:在文本两侧使用 *** 。
引用
在段落前使用 > 表示引用,使用多个 > 可以嵌套,如: >> 、 >>> 等。
列表
- 无序列表
- 在文本前使用 - 、 * 或 + ,可以生成列表项。使用缩进可以嵌套。
- 有序列表
- 在文本前使用 数字. 后(例如 1. ),敲空格即可生成有序列表项。使用缩进可以嵌套。
代码
- 单行代码,在文本两侧使用反引号 ` 。
- 代码中包含反引号 ` ,需要在文本两侧使用双反引号 `` 。
- 代码块,Markdown的基本语法允许通过 缩进四个空格 或 一个制表符 直接创建代码块。也可以在代码块开始的前一行和代码块结束的下一行使用三个反引号 ```包裹,创建代码块,开始的三个反引号后可跟 语言描述 ,来指定代码语言。
例如:
``` java
public static void main(String args[]) {
//do something...
}
分割线
在单独一行使用三个或多个短横线 --- 、星号 *** 或下划线 _ _ _ 来创建分割线。
链接
- 普通链接,链接语法 [显示文字](链接地址 "title文字") 例如:[百度](https://www.baidu.com “百度”)
- 快速链接,用尖括号 < 和 > 把链接包裹起来,例如:https://www.baidu.com、example@qq.com
- 引用类型的链接,语法 [显示文字][label] 和 [label]: 链接地址 ,注意: [label]: 必须在行头,并且后要跟一个 空格
- 例如:[百度][baidu_label] 引用 [baidu_label]: https://www.baidu.com
图片
图片语法 
转义字符
转义字符使用 \
- 可以转义的特殊字符如下
\、 `、 * 、 _ 、 {} 、 [] 、 () 、 # 、 + 、 - 、 . 、 ! 、 |
- 两个特殊字符
< 使用 < 替换; & 使用 & 替换。
内嵌HTML
Markdown语法支持直接写HTML标签,只是对于块级元素,例如 div 、 table 、 pre 、 p 等,为了兼容性最好在代码块的前后分别加上一行 空行 。示例:
This is a regular paragragh...
This is a regular paragragh...
扩展语法
表格
使用 | 分隔每一列,使用三个或多个短横线 --- 来分隔表头和内容。在 --- 两端加 : 可以分别实现左对齐、右对齐、居中对齐,例如:
- 左对齐: :---
- 右对齐: ---:
- 剧中对齐: :---:
完整示例:
| 姓名 | 班级 | 成绩 |
| :--- | ---: | :---: |
| 张三 | 一班 | 88 |
| 李四 | 二班 | 99 |
删除线
在文本两侧使用 ~~ 可以在文本上画删除线。
任务列表
语法 - [ ] 任务描述 ,并非所有markdown应用都支持。例如:
- [ ] Write the press release
- [x] Update the website
- [ ] Contact the media
呈现结果如下:
- [ ] Write the press release
- [x] Update the website
- [ ] Contact the media