syntaxOfMarkdown
这是一篇介绍Markdown常用语法兼练习的博客。
Markdown 标题语法
标题使用#号+空格
标记,空格一定不要少!几个#
代表几级标题。以下例子是一个四级标题,使用了#### 四级标题
。
四级标题
Markdown语法练习
Markdown语法练习
Markdown语法练习
Markdown语法练习
Markdown语法练习
Markdown语法练习
Markdown 段落语法
要创建段落,请使用空白行将一行或多行文本进行分隔。
Markdown语法中段落不需要缩进(空格或制表符)。
Markdown 换行语法
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(为了兼容最好使用(<br>
)。
现在这句话就换行了。
Markdown 强调语法
斜体文字
用* *
或_ _
包裹(一道下划线)
粗体文字
用** **
或__ __
包裹(两道下划线)
斜粗体文字
用*** ***
或___ ___
包裹(三道下划线)
Markdown 引用语法
要创建块引用,请在段落前添加一个 >
符号(记得>
后面加空格
)。
这是一个块引用
多个段落的块引用
块引用可以包含多个段落。为段落之间的空白行添加一个 >
符号(其实就是在行末敲一次回车)。
这是第一段
这是第二段
嵌套块引用
块引用可以嵌套。在要嵌套的段落前添加一个 >>
符号(在块引用内再次使用>
加空格
)。
这是第一段
这是第二段
带有其它元素的块引用
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。
1 | > #### The quarterly results look great! |
渲染效果如下:
The quarterly results look great!
- Revenue was off the chart.
- Profits were higher than ever.
Everything is going according to plan.
Markdown 列表语法
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
- 有序列表1
- 有序列表2
- 有序列表3
- 有序列表1
- 有序列表2
- 有序列表4
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表(切记三种符号不要混一起用)。
- 无序列表1
- 无序列表2
- 无序列表3
- 无序列表1
- 无序列表2
- 无序列表4
在列表中嵌套其他元素
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符,如下例所示:
1 | * This is the first list item. |
渲染效果如下:
This is the first list item.
Here’s the second list item.
I need to add another paragraph below the second list item.
And here’s the third list item.
有序列表嵌套模拟:
1 | 1. 有序列表1 |
渲染效果如下:
有序列表1
有序列表2
有序列表打断
有序列表
Markdown 代码语法
将单词或词语表示为代码
,用一对`
(反引号)包裹。
转义反引号
如果要表示为代码的内容里已经包含了反引号,用一对**``**(双反引号)包裹。
例如:这里有`代码`
,`
注意空格。
代码块
使用三个反引号(```)或三个波浪号(~~~),然后可以打出使用的语言类型。
1 | ```language |
1 | printf("Hello World!"); |
1 | System.out.println("Hello World!"); |
1 | console.log("Hello World!") |
Markdown 分隔线语法
在单独一行上使用三个或多个星号 (***
)、破折号 (---
) 或下划线 (___
) ,并且不能包含其他内容(可以在其中包含空格)。另外,为了兼容性,请在分隔线的前后均添加空白行。
1 | *** |
渲染效果如下:
Markdown 删除线语法
在要加删除线文字的两端加上两个波浪线~~
。例子如下:
这是一个删除练习语句。
这是一个粗体删除语句。
Markdown 下划线语法
下划线可以通过 HTML 的<u>
标签来实现。
1 | <u>下划线</u> |
渲染效果如下:
下划线
Markdown链接语法
链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
1 | 语法:[超链接显示名](超链接地址 "超链接title") |
对应的HTML代码:<a href="超链接地址" title="超链接title">超链接显示名</a>
例如,[Markdown官方文档](Markdown 链接语法 | Markdown 官方教程)。
链接的内容在Typora和网页中不一样,尚未解决。建议用html语法或者直接放链接,不用格式。例如:本文参考了JayHrn的文章。
链接title
链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
Markdown脚注语法
脚注是对文本的补充说明。在要加脚注的文字后面写上:[^x]
,x可以是数字或单词。
1 | 格式:[^文本]: (英文冒号) |
渲染效果如下:
这是一段话。这是第二段话^1。嗯。我要为这段话添加一些脚注^2。
脚注的渲染在Typora和网页中不一样,尚未解决。
Markdown 图片语法
图片语法参考官方文档,配置好PicGo后基本用不到。
Markdown 内嵌 HTML 标签
一些Markdown语法中不存在的标签/功能,可以通过HTML标签实现,直接写入即可。
对于 HTML 的块级元素 <div>
、<table>
、<pre>
和 <p>
,请在其前后使用空行(blank lines)与其它内容进行分隔。
在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p>
将不起作用。