# Markdown 语法
什么?还不知道啥是Markdown?猛戳Markdown (opens new window)
TIP
本文中包含部分Markdown的扩展语法,可能你正在使用的markdown编辑器并不支持,碰到相应情况并且对该扩展语法感兴趣的话,可在评论区留言一起交流~
目前本文中所有语法在GitHub上皆可实现
# 标题
语法:
标题名前加#(#后留一个空格,可加1-6个#代表不同级别标题)
代码示例:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
代码效果见下:
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# 文本
# 换行
语法:
在要换行处输入两个空格然后回车(直接只回车是没用的,不过可以回车两次,只是行间距会比较大)
代码示例:
第一行文本(在这里输入两个空格然后回车)
第二行文本
代码效果见下:
1
2
3
4
5
6
2
3
4
5
6
第一行文本
第二行文本
# 文本样式
样式 | 语法 | 代码示例 | 代码效果 |
---|---|---|---|
正常 | 无 | 文本 | 文本 |
斜体 | * * 或_ _ | *文本* 或_文本_ | 文本 |
粗体 | ** ** 或__ __ | **文本** 或__文本__ | 文本 |
粗斜体 | *** *** 或___ ___ | ***文本*** 或___文本___ | 文本 |
删除线 | ~~ ~~ | ~~文本~~ |
备注:粗体、斜体、删除线可以和粗斜体那样混合使用。
# 引用
语法:
引用的文本前加>(>后可不留一个空格,但建议留一个以便养成良好习惯)
代码示例:
> 引用的文本
代码效果见下:
1
2
3
4
5
2
3
4
5
引用的文本
# 代码
# 行内代码
语法:
引用的代码前后各加一个反引号(英文输入法下,Tab键上面那个键)
代码示例:
Use `git status` to list all new or modified files that haven't yet been committed.
代码效果见下:
1
2
3
4
5
2
3
4
5
Use git status
to list all new or modified files that haven't yet been
# 区块代码
语法:
引用的代码块上下一行各加三个反引号`(英文输入法下,Tab键上面那个键)
代码示例:
```
function test() {
console.log("honkerzhou is a handsome boy");
}
```
代码效果见下:
function test(){
console.log("honkerzhou is a handsome boy");
}
1
2
3
2
3
# 代码高亮
语法:
引用的代码块上下一行各加三个反引号,并在第一个三个反引号后加上语言标识符(如:javascript)。
代码示例:
```javascript
function test() {
console.log("honkerzhou is a handsome boy");
}
```
代码效果见下:
function test() {
console.log("honkerzhou is a handsome boy");
}
1
2
3
2
3
附加:点击查看GitHub支持代码高亮的所有语言 (opens new window)
# 链接
# 外部链接
语法:
[链接的描述](URL)
代码示例:
[honkerzhou的博客](http://www.honkerzhou.com/blog)
代码效果见下:
1
2
3
4
5
2
3
4
5
honkerzhou的博客 (opens new window)
# 内部链接
语法:
[链接的描述](#要跳到的标题名)
代码示例:
[跳到表情处](#表情)
代码效果见下:
1
2
3
4
5
2
3
4
5
# 图片
语法:
![图片加载失败时显示的内容](URL "鼠标移到图片上时显示的内容")
URL后面的内容可加可不加,要加的话URL后面需留一个空格
代码示例:
![帅哥](./markdown-title.png "honkerzhou")
代码效果见下:
1
2
3
4
5
6
2
3
4
5
6
# 列表
# 有序列表
语法:
数字后加一个小数点再加一个空格
代码示例:
1. 第一天
2. 第二天
3. 第三天
代码效果见下:
1
2
3
4
5
6
7
2
3
4
5
6
7
- 第一天
- 第二天
- 第三天
# 无序列表
语法:
减号或星号后加一个空格(推荐用减号,可以少按一个Shift键)
代码示例:
* 中国
* 小明
- 地板
代码效果见下:
1
2
3
4
5
6
7
2
3
4
5
6
7
- 中国
- 小明
- 地板
# 嵌套列表
语法:
和有序无序类似,主要是混合使用有序和无序
代码示例:
1. 中国
- 北京
- 深圳
- 宝安区
- 福田区
代码效果见下:
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
- 中国
- 北京
- 深圳
- 宝安区
- 福田区
# 任务列表
语法:
减号加一个空格再加一个中括号再加一个空格(中括号中保留一个空格,如果完成了,就把中括号中的空格改为字母x)
代码示例:
- [x] 写Markdown语法总结
- [ ] 月入百万
- [ ] 环游世界
代码效果见下:
1
2
3
4
5
6
7
2
3
4
5
6
7
- [x] 写Markdown语法总结
- [ ] 月入百万
- [ ] 环游世界
# 表情
语法:
:表情代码:
代码示例:
:100:
代码效果见下:
1
2
3
4
5
2
3
4
5