Markdown教程
Markdown 标题
- 使用
=
和-
标记一级和二级标题
1 | 一级标题 |
- 使用
#
号标记
使用#
号可表示 1-6 级标题,一级标题对应一个#
号,二级标题对应两个#
号,以此类推。
1 | # 一级 |
Markdown 段落
1.段落的换行是使用两个以上空格加上回车
2.字体
1 | *斜体文本* |
3.分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
1 | *** |
1 | 111 |
4.删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~
即可,实例如下:
1 | ~~11~~ |
演示效果
5.下划线
下划线可以通过 HTML 的 <u>
标签来实现:
1 | <u>下划线</u> |
下划线
列表
1.无序与有序列表
1 | * 第一项 |
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
有序列表使用数字并加上 .
号来表示,如:
1 | 1. 第一项 |
- 第一项
- 第二项
- 第三项
2.列表嵌套
列表嵌套只需在子列表中的选项前面添加两个或四个空格即可:
1 | 1. 第一项: |
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
区块
1.普通区块
Markdown 区块引用是在段落开头使用 >
符号 ,然后后面紧跟一个空格符号:
1 | > 区块引用 |
区块引用
区块引用 2
区块引用 3
2.区块嵌套
一个 >
符号是最外层,两个 >
符号是第一层嵌套,以此类推:
1 | > 最外层 |
最外层
第一层嵌套
第二层嵌套
3.区块中使用列表
1 | > 区块中使用列表 |
区块中使用列表示例
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
4.列表中使用区块
如果要在列表项目内放进区块,那么就需要在 >
前添加四个空格的缩进。
- 第一项
区块 1
区块 2 - 第二项
区块 1
区块 2
代码块
1.单函数或片段
如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),例如:
1 | `printf()` 函数 |
printf()
函数
2.代码区块
代码区块使用 4 个空格或者一个制表符(Tab 键)。
你也可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定)
链接
链接使用方法如下:
1 | [链接名称](链接地址) |
1 | 这是一个链接 [百度](https://www.baidu.com) |
这是一个链接 百度
图片
Markdown 图片语法格式如下:
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
开头一个感叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 title
属性的文字。
![test图片](https://pic.imgdb.cn/item/66018ab59f345e8d0320eb82.jpg "测试图片")
Markdown 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的 <img>
标签。
<img src="https://pic.imgdb.cn/item/66018ab59f345e8d0320eb82.jpg" width="50%">
表格
Markdown 制作表格使用 |
来分隔不同的单元格,使用 -
来分隔表头和其他行。
1 | | table1 | table2 | table3 | |
预览:
table1 | table2 | table3 |
---|---|---|
test1 | test2 | test3 |
test4 | test5 | test6 |
对齐方式
我们可以设置表格的对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
实例如下:
1 | | 左对齐 | 右对齐 | 居中对齐 | |
预览:
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
1 | 1 | 1 |
1 | 1 | 1 |
其他
支持的 HTML
元素不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML
撰写。
目前支持的 HTML 元素有:
<kbd> <b> <i> <em> <sup> <sub> <br>
例如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
使用 Ctrl+Alt+Del 重启电脑