一、Markdown 标题
1.使用 = 和 - 标记一级和二级标题
例如:
1 | 一级标题 |
效果:
一级标题
二级标题
2.使用 #
号标记
使用 #
号可表示 1-6 级标题,一级标题对应一个 #
号,二级标题对应两个 #
号,以此类推。
例如:
1 | # 一级标题 |
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
二、Markdown 段落
1.换行
由于编辑器的不同,在换行的处理上有细微差异
1.末尾添加两个空格换行
2.回车空行来换行
3.使用HTML中的<br>
标签强制换行
2.字体
例如 :
1 | *斜体文本* |
效果:
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本我是删除线
下划线
下划线可以通过 HTML 的 <u>
标签来实现:
<u>带下划线文本</u>
效果:
带下划线文本
3.分割线
例如:
1 | *** |
效果:
4.脚注
脚注是对文本的补充说明。
Markdown 脚注的格式如下:[^要注明的文本]
1 | 创建脚注格式类似这样 [^RUNOOB]。 |
效果:
创建脚注格式类似这样 ^脚注。
5.空格缩进
例如:
1 | 没有空格 |
效果:
没有空格
一个空格
两个空格
一个空格不会触发换行
三、Markdown 列表
1.无序列表
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记.
例如:
1 | * 第一项 |
效果:
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
2.有序列表
有序列表使用数字并加上 . 号来表示
例如:
1 | 1. 文本1 |
效果:
- 文本1
- 文本2
- 文本3
3.列表嵌套
例如:
1 | 1. 第一项: |
效果:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
四、Markdown 区块
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号
1.一级区块
例如:
1 | > 区块引用 |
效果:
区块引用
区块引用
区块引用
2.区块嵌套
另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:
1 | > 最外层 |
效果:
最外层
第一层嵌套
第二层嵌套
五、Markdown 代码
单行代码使用` …`包裹
多行代码使用```…```包裹
1 | $(document).ready(function () { |
六、Markdown 链接
1.链接使用方法如下:
1 | [链接名称](链接地址) |
例如:
1 | 这是一个链接 [百度](https://www.baidu.com) |
效果:
这是一个链接 百度
例如
1 | <https://www.baidu.com> |
效果:
2.高级链接
例如:
1 | 链接也可以用变量来代替,文档末尾附带变量地址: |
效果:
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 Google
这个链接用 link 作为网址变量 百度
然后在文档的结尾为变量赋值(网址)
七、Markdown 图片
语法:
1 | ![alt 属性文本](图片地址) |
例如:
1 | ![哔哩哔哩](https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=2810627290,1080409091&fm=58&s=8197C732C535FA313E526557030030BB&bpow=121&bpoh=75 "bilibili") |
效果:
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img>
标签。
八、Markdown 表格
Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
例如:
1 | |表头|表头|表头| |
效果:
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
九、Markdown 高级技巧
1.支持的 HTML 元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>
等 ,如:
例如:
使用<kbd>Ctrl</kbd>+<kbd>C</kbd>
复制
效果:
使用Ctrl+C复制
2.转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符。
例如:
1 | **文本加粗** |
效果:
文本加粗
** 正常显示星号 **
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号
1 | \ 反斜线 |