基本语法
段落
- 段落由一个或多个连续的文本行组成,它的前后要有一个以上的空行。
- 若某一行只包含空格和制表符,则也会被视为空行。
- 段落内的强迫换行(插入换行符),在插入处先按入两个以上的空格然后回车。
标题
- 在行首插入 1 到 6 个井号
#
,对应到标题 1 到 6 阶。
强调
- 星号
*
或底线_
包起来的内容变为斜体 - 两个星号
**
或底线__
包起来的内容变为粗体 - 强调可以直接插在文字中间
区块引用
- 在每行的最前面加上大于号
>
- 也可以偷懒只在整个段落的第一行最前面加上
>
- 嵌套区块引用只需要根据层次加上不同数量的
>>
等
小段行内代码
- 要标记一小段行内代码,你可以用反引号
`
把它包起来 - 要插入反引号,可以用多个反引号来开启和结束代码区段
代码区块
- 推荐方法,在区块行首和区块尾加上三个反引号
(```)
- 开头加上一个缩进(4 个空格或是 1 个制表符),建立代码区块
- 在列表中插入时要两个缩进
- 代码区块会一直持续到没有缩进的那一行(或是文件结尾)
列表
- 无序列表使用星号
*
、减号-
或是加号+
作为列表标记 - 有序列表使用数字接着一个英文句点
1.
- 在行首出现数字-句点-空白时,在句点前面加上反斜杠
2017\.
- 列表可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符
- 如果要在列表项目内放进引用,那
>
的前面就需要缩进 - 如果要放代码区块,该区块就需要缩进两次
分隔线
- 在一行中用三个以上的星号
*
、减号-
、底线_
来建立一条分隔线 - 行内不能有其他东西。但可以在符号中间插入空格
插入链接
行内式的链接
- 方块括号后面紧接着圆括号:
[显示文字](链接地址)
- 如果需要链接的 title 文字,在链接地址后面,加空格再用双引号把 title 文字包起来。如:
[an example](http://example.com/ "Title")
- 如果是链接到同样主机的资源,可以使用相对路径
参考式的链接
- 在链接文字的方括号后再接上另一个方括号,其中填入链接的标记:
[an examp][id]
- 然后,可以在文件的任意处,把该标记的链接内容定义出来:
[id]:http://example.com/ "Optional Title Here"
- 链接内容定义的形式为:
- 方括号(前面可选择加上最多三个空格来缩进),里面输入链接标记
- 接着一个冒号,接着一个以上的空格或制表符
- 接着链接的网址,接着一个以上的空格或制表符
- 可选接着 title 内容,可以用双引号包着
- 链接标记可以有字母、数字、空白和标点符号,但是不区别大小写
插入图片
- 类似插入链接,分为行内式和参考式
- 区别是在插入时,前面加上感叹号
!
- 参考式定义标记的链接内容时不需要感叹号
其他
自动链接
- 直接用尖括号包起来, Markdown 就会自动把它转成链接:
<http://example.com/>
反斜杠
- 可以利用反斜杠来插入一些在语法中有其它意义的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号