layout: post
title: Makedown语法简介
description:
category: 编辑
tags: makedown
段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。
简单说:连续两个回车完成对段落的换行。
标题
在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加四个以上的“=”和“-”,他们分别表示一级标题和二级标题。例如:
H1
=======
H2
-------
H1
H2
第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)例如:
# H1
## H2
##### H5
H1
H2
H5
引用
通过在文字开头添加“>”表示块注释。区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
:
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
* Red
* Green
* Blue
- Red
- Green
- Blue
等同于:
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
也等同于:
- Red
- Green
- Blue
- Red
- Green
- Blue
有序列表则使用数字接着一个英文句点:
1. Bird
2. McHale
3. Parish
- Bird
- McHale
- Parish
代码
实现方式有两种:
第一种:简单文字出现一个代码框。使用`(不是单引号而是左上角的ESC下面~中的
)
`<blockquote>`
<blockquote>
第二种:大片文字需要实现代码框。使用Tab和四个空格。
int main()
{
//
}
分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
***
---
链接
Markdown中有两种方式实现链接,分别为内联方式和引用方式,不管是哪一种,链接文字都是用 [方括号] 来标记。
内联方式:
This is an [example link](http://example.com/).
This is an example link.
引用方式:
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
...
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
…
[1]: http://google.com/ “Google”
[2]: http://search.yahoo.com/ “Yahoo Search”
[3]: http://search.msn.com/ “MSN Search”
强调
Markdown 使用星号(*
)和底线(_
)作为标记强调字词的符号,被 *
或 _
包围的字词会被转成用 <em>
标签包围,用两个 *
或 _
包起来的话,则会被转成 <strong>
,例如:
1个为斜体,两个为粗体。
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
single asterisks
single underscores
double asterisks
double underscores
你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束。
强调也可以直接插在文字中间:
un*frigging*believable
unfriggingbelievable
但是如果你的 *
和 _
两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
\*this text is surrounded by literal asterisks\*
*this text is surrounded by literal asterisks*
图片
图片的处理方式和链接的处理方式,非常的类似。
内联方式:
![alt text](/path/to/img.jpg "Title")
引用方式:
![alt text][id]
...
[id]: /path/to/img.jpg "Title"
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em>
标签),你可以在星号的前面加上反斜杠:
\*literal asterisks\*
*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
References: