摘要:Markdown 的语法全由标点符号所组成,比较简单,并经过严谨慎选。Markdown 不是要来取代 HTML,而是让文档更容易阅读、编写。(一定要注意空格,个别地方有差异请审查元素)
基本写作
1.标题
Markdown支持两种标题的语法,Setext和atx形式。
atx:由16个h6#
(空格)和标题字组成,分别对应h1
1 | # 一级标题 |
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
Setext:由标题字和下划线=
或-
组成,任何数量的=
或-
都可以,但为了避免出错,建议输入=
或-
的数量不少于3个
1 | 一级标题 |
一级标题
二级标题
2.段落
段落文本前要有一行或多行空白行
1 |
|
段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一段落一
段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二段落二
3.粗体、斜体
由*
或_
和文本组成,文本可以跨行但不可空行,文字之间可以有空格,单是斜体,双是粗体
1 | *这是 |
这是
斜体
这是
粗体
4.分割线
由至少三个*
或_
或-
之一组成,单独一行可以有空格
1 | ** * |
5.代码
单行内的代码使用反引号(
)将代码包裹
1 | 这是`单行内的代码` |
这是单行内的代码
大段的代码块要在每行前加4个空格或一个tab,而且有一些 HTML 区块元素――比如<div>
、<table>
、<pre>
、<p>
等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。另一个更简单的方法是代码块前后行都加上三个反引号(```.
1
代码块前后行都加上三个反引号(```.
1 | 代码块前后行都加上三个反引号(```) |
6.使用HTML语言
可以直接使用HTML语言,但前后都要有空行
1 | <div style="color:red">可以直接使用HTML语言,但有些标签前后都要有空行</div> |
7.注释
Markdown中的注释与HTML的注释一样
1 | <!-- Markdown中的注释与HTML的注释一样 --> |
8.转译
部分字符在Markdown中会自动转译,可以利用反斜杠来\
插入一些在语法中有其它意义的符号,Markdown支持的转义字符列表:
1 | \ 反斜线 |
引用
文字引用在文本前加入>大于号(空格)即可
1 | > 引用 |
引用
多级引用嵌套需要需要这样写
1 | > 一级引用 |
一级引用
二级引用
三级引用
列表
1.无序列表,由*
或+
或-
(空格)和文本组成,建议一个列表尽量使用其中一种符号。
1 | + 第一 |
- 第一
- 第二
- 第三
2.有序列表,由数字和 . (空格)与文本组成,数字无需按大小排序,会自动编辑排序
1 | 1. 第一 |
- 第一
- 第二
- 第三
链接
1.Inline方式,文字链接,”title”可有可无
1 | [奔跑的牛](https://niuxiaokui.github.io "title") |
2.图片链接,大小只能借助HTML来设置,”title”可有可无
1 | ![alt](https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=3001304778,4021565056&fm=96 "title") |
3.自动链接,尖括号(大于号、小于号)包裹地址
1 | <https://niuxiaokui.github.io> |
4.索引链接
1 | [奔跑的牛][1] |
表格
1 | | 左对齐标题 | 右对齐标题 | 居中对齐标题 | |
左对齐标题 | 右对齐标题 | 居中对齐标题 |
---|---|---|
短文本 | 中等文本 | 稍微长一点的文本 |
稍微长一点的文本 | 短文本 | 中等文本 |
注意: | ||
1.` | 、 -、 :`之间的多余空格会被忽略,不影响布局。 |
|
2.默认标题栏居中对齐,内容居左对齐 | ||
3.-: 表示内容和标题栏居右对齐,:- 表示内容和标题栏居左对齐,:-: 表示内容和标题栏居中对齐。 |
||
4)内容和` | 之间的多余空格会被忽略,每行第一个 |
和最后一个 |