一、基础语法
1.标题
(1)atx形式:
# 表示一级标题,即HTML语言中的<h1></h1>标签
## 表示二级标题,即HTML语言中的<h2></h2>标签
……
######表示六级标题,即HTML语言中的<h6></h6>标签
(2)Setext形式:
= 底线 表示最高阶标题,即HTML语言中的<h1></h1>标签
- 底线 表示二阶标题,即HTML语言中的<h2></h2>标签
2.段落
一个段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示上看起来像是空行,例如只有空白和tab)。
注意,一个以上空行的意思是,当前行输入完毕换行后,再次按下回车键换行,这样即为一个以上空行。显示上看起来是两行文字之间留出一行了空白行。
段落即为HTML语言中的<p></p>
3.区块
> 表示区块,即首行缩进一个单位长度(通常为四个空格的长度),即HTML语言中的<blockquote></blockquote>
4.列表
* 无序列表,对应HTML语言中的<ul><li></li><ul>
+ 无序列表,对应HTML语言中的<ul><li></li><ul>
- 无序列表,对应HTML语言中的<ul><li></li><ul>
1. 有序列表,数字加英文句点,对应HTML语言中的<ol><li></li></ol>
注意:
你在列表标记上使用的数字并不会影响HTML的输出结果。如果你使用懒惰的写法,建议第一个项目最好从1.开始,因为Markdown未来有可能会支持有序列表的start属性。
如果在插入列表时,在列表的两项之中插入了空行,则该项内容会用<p>标签包裹起来,你也可以在一项中插入多个段落,只要正确的保证了空行,并且最好开头能够空出四个空格或一个tab,或者是添加一个>使它变成区块,这样和列表显示起来比较整齐。
5.链接
Markdown支持两种形式的链接语法:行内和参考两种形式。
(1)行内形式:
格式:This is an [example link](www.example.com)
解释:在HTML语言中即为,将example link包裹在<a>标签中,并且href地址为www.example.com。
格式:This is an [example link](www.example.com "With a title")
解释:基本同上,区别是指定了该a标签的title属性值为With a title。
(2)参考形式:
参考形式的链接可以让你为链接定一个名称,之后在其他地方统一定义链接的内容。
格式:This is an [example link][1], and [the second example link][2].
[1]: www.example.com
[2]: www.example2.com "title"
解释基本同上,需要注意的地方是,[1]不一定非要使用数字,可以使用字母、数字和空格或其组合,但是不分大小写。
6.图片
图片的语法和链接很像,也分为行内形式和参考形式两种。
(1)行内形式(title是选择性的):
![alt text](/path/to/image.jpg "Title")
(2)参考形式:
![alt text][id]
[id]: /path/to/image.jpg "Title"
上面两种形式都会输出HTML为:<img src="path/to/image.jpg" alt="alt text" title="Title">
7.代码
Markdown文档中如果输入HTML代码,是会直接生效的。如果想要显示出一一段代码来而不是让它被解析运行,就使用 ` ` (反引号,英文模式下按键盘左上角的波浪号键,注意不能跨行)将代码部分包裹起来,这样就可以显示出原原本本的代码了。
8.分割线
可以在一行中使用三个以上的星号、减号、底线来建立一个分割线,行内不能有其他东西。也可以在星号或减号中间插入空格。
如:* * *
- - -
******
------
9.强调
使用星号(*)和底线(_)作为标记强调字符的符号,被一个(*)或(_)包围的内容会以<em>标签的形式显示,即斜体。被两个(*)或(_)包围的内容将会以<strong>标签的形式显示,即加粗。
注意,如果(*)或(_)的两边有空白,则会显示成普通的星号或底线。如果想要在文字前后直接插入普通的星号或底线,则需要用到转义字符(\)。