文章目录
Markdown语法学习
Markdown标题语
1、要创建标题,请再单词或短语前加井号(#)。#的数量代表了标题的级别
2、还可以在文本下方添加任意数量的==号来标识一级标题,或者–号来标识二级标题
Markdown段落语法
要创建段落,请使用空白行将一行或多行文本进行分隔
不要用空格(spaces)或制表符(tabs)缩进段落
Markdown换行语法
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行
几乎每个Markdown应用程序都支持另一种换行方式:HTML的 (<b+r>,其中+不计)标签
Markdown强调语法
通过将文本设置为粗体或斜体来强调其重要性
粗体
要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)。如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)
斜体
要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。要斜体突出单词中间部分,请在字母前后各添加一个星号,中间不要带空格。
粗体和斜体
要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分,请在要突出显示的部分前后各添加***三个星号***,中间不带空格。
Markdown引用语法
要创建块引用,请在段落前添加一个>符号
符号
多个段落的块引用
块引用可以包含多个段落。为段落之间的空白行添加一个>符号
例如
这样
嵌套块引用
块引用可以嵌套。在要嵌套的段落前添加一个>>符号
例如
这样
带有其他元素的块引用
块引用可以包含其他Markdown格式的元素。并非所有元素都可以使用,需要进行实验查看哪些元素有效
such as
- this
- and
this
Markdown列表语法
可以将多个条目组织成有序或无序列表
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字1起始。
- 例如
- 这样
- such
- as
无序列表
要创建无序列表,请在每个列表项前面添加破折号(-)、星号(*)或加号(+)。缩进一个或多个列表项可创建嵌套列表
- like
*this
在列表中嵌套其他元素
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。
- let me
try try - is there any difference?
maybe
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1fMoNoNq-1645783112039)(/assets/images/tux.png)] - but i cannot tell
- haha
Markdown代码语法
要将单词或短语表示为代码,请将其包裹在反引号`中
like this
转义反引号
如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词包裹在双反引号中
such `as` this
代码块
要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符
Markdown分隔线语法
要创建分隔线,请在单独一行上使用三个或多个星号(***)、破折号(—)或下划线(___),并且不能包含其他内容
Markdown 链接语法
链接文本放在中括号中,链接地址放在后面的括号中,链接title可选
超链接Markdown语法代码:超链接显示名
这是一个链接Markdown语法。
给链接增加title
链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
这是一个链接Markdown语法
网址和Email地址
使用尖括号可以很方便地把URL或者email地址变成可点击的链接
http://markdown.com.cn
fake@example.com
带格式化的链接
强调链接,在链接语法前后增加星号。要将链接表示为代码,请在方括号中添加反引号。
i love supporting the EFF
This is the Markdown Guide.
See the section on [code
]
引用类型链接
引用样式链接是一种特殊的链接,它使URL(Uniform Resource Locator,统一资源定位符)在Markdown中更易于显示和阅读。
链接的第一部分
引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为连接的文本。第二组括号显示了一个标签,该标签用于指向你存储在文档其他位置的链接。
可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。
以下示例格式对于链接的第一部分效果相同:
- hobbit-hole
- [hobbit-hole] 1
链接的第二部分
引用类型链接的第二部分使用以下属性设置格式:
- 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如 [label]: )。
- 链接的URL,可以选择将其括在尖括号内。
- 链接的可选标题,可以将其括在双引号,单引号或括号中。
以下示例格式对于第二部分效果相同:
不同的Markdown应用程序处理URL中间的空格方式不一样。为了兼容性,请尽量使用 %20 代替空格。
[link]
(https://www.example.com/my%20great%20page)
Markdown图片法
要添加图像,请使用感叹号(!),然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码: [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-o1iC9pSm-1645783112041)(图片链接 “图片title”)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qhZkJ0Aq-1645783112042)(/assets/img/philly-magic-garden.jpg “Magic Gardens”)]
链接图片
给图片增加链接,请将图像的Markdown括在方括号中,然后将链接添加在圆括号中。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-NPL6wquW-1645783112043)(/assets/img/shiprock.jpg “Shiprock”)]
Markdown转义字符语法
要显示原本用于格式化Markdown文档的字符,请在字符前添加反斜杠字符\。
例如
* Without the backslash, this would be a bullet in an unordered list. Like the sentence below.
- Without the backslash, this would be a bullet in an unordered list.
可做转义的字符
Character | Name |
---|---|
\ | backslash |
` | backtick (see also escaping backticks in code) |
* | asterisk |
_ | underscore |
{} | curly braces |
[] | brackets |
() | parentheses |
# | pound sign |
. | dot |
! | exclamation mark |
| | pipe(see also escaping pipe in tables) |
特殊字符自动转义
在HTML文件中,有两个字符需要特殊处理:< 和 &。<符号用于起始标签,&符号则用于标记HTML实,如果你只是想要使用这些符号,你必须要使用实体的形式,像是< 和 & 。
Markdown允许直接使用这些符号,会自动转义这些字符。如果使用&符号作为HTML实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 & 。所以如果要在文件中插入一个著作权的符号,可以这样写:
©
Markdown将不会对这段文字做修改,但是如果这样写(并没有变化)
AT&T
Markdown将会把它转换为:
AT& amp;T
类似的情况也会发生在<符号上,因为Markdown支持行内HTML,如果你是用<符号作为HTML标签的分隔符,那Markdown也不会对它做任何转换,但是如果是写:
4 < 5
Markdown会把它转换为:
4 < 5
Markdown内嵌HTML标签
对于Markdown涵盖范围之外的标签,都可以直接在文件里用HTML本身。如需使用HTML,不需要额外标注这是HTML或是Markdown,只需HTML标签添加到Markdown文本中即可。
行级内联标签
HTML的行级内联标签如 <span>(用于对文档中的行内元素进行组合) 、 <cite> 、<del> 不受限制,可以在Markdown的段落、列表或标题中任意使用。
This word is bold. This word is italic.
区块标签
区块元素 —— 比如
<div> 、 <table> 、 <pre> 、 <p> 等标签,必须在前后行加空行, 以便于内容区分。
而且这些元素的开始与结尾标签,不可以用tab或空白来缩进。Markdown会自动识别这区块元素,避免在区块标签前后加上没有必要的 <p> 标签。
例如,在Markdown文件中加上一段HTML表格:
This is a regular paragraph.
<tr>
<td>Foo</td>
</tr>
输出:
Foo |
This is another regular paragraph.
我的母亲有 蓝色 的眼睛
绘制流程图
举例如下
graph TD
A[可行性分析]-->B[需求分析]
style A fill:#f9f;
style B fill:#f
B[需求分析]-->C[设计]
C[设计]-->D[编码]
D[编码]-->E[测试]
E[测试]-->F[发布]
Markdown 合并表格
Markdown没有单元格合并语法,但是Markdown是兼容HTML的,因此可以用过HTML的方式实现单元格合并。
基础HTML表格如下:
<tr>
<td>行1列1</td>
<td>行1列2</td>
<td>行1列3</td>
</tr>
<tr>
<td>行2列1</td>
<td>行2列2</td>
<td>行2列3</td>
</tr>
<tr>
<td>行3列1</td>
<td>行3列2</td>
<td>行3列3</td>
</tr>
输出:
行1列1 | 行1列2 | 行1列3 |
行2列1 | 行2列2 | 行2列3 |
行3列1 | 行3列2 | 行3列3 |
其中每对…标签之间代表一行,…标签之间代表一列
合并行
colspan:规定单元格可纵跨的列数,即跨几列来合并行。
行1列1 | 行1列2 | 行1列3 |
行2列1 | 跨两列合并行 | |
跨三列合并行 |
合并列
rowspan:规定单元格可横跨的行数,跨几行来合并列。
<tr>
<td>行1列1</td>
<td>行1列2</td>
<td>行1列3</td>
</tr>
<tr>
<td rowspan="3">跨两行合并列</td>
<td>行2列2</td>
<td>行2列3</td>
</tr>
<tr>
<td>行3列2</td>
<td>行3列3</td>
</tr>
<tr>
<td>行3列2</td>
<td>行3列3</td>
</tr>
输出:
行1列1 | 行1列2 | 行1列3 |
跨两行合并列 | 行2列2 | 行2列3 |
行3列2 | 行3列3 | |
行3列2 | 行3列3 |
在第一列合并了第二三行,则在第二行写合并,第三行就不用再写第一列了。
合并行列输入如下
<tr>
<td colspan="2",rowspan="2" >跨两行合并列</td>
<td>行1列3</td>
</tr>
<tr>
<td>行2列3</td>
</tr>
<tr>
<td>行3列1</td>
<td>行3列2</td>
<td>行3列3</td>
</tr>