标题
这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。
而在 Markdown 中,你只需要在文本前面加上#
即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加#
即可,标题字号相应降低。例如:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
注:#和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
你可以你的编辑器中尝试输入这六级标题,可以参考下方的截图:
列表
列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 -
就可以了,例如:
- 文本1
- 文本2
- 文本3
如果你希望有序列表,也可以在文字前面加上 1. 2. 3.
就可以了,例如:
- 文本
- 文本
- 文本
注:-
、1.
和文本之间要保留一个字符的空格。
列表案例截图如下:
链接
在 Markdown 中,插入链接不需要其他按钮,你只需要使用<http://example.com/>
,即用<>
包裹住链接就行了,当然,如果是要对某一些文字加上链接,则使用 [显示文本](链接地址)
这样的语法即可,例如:简书
[简书](http://www.jianshu.com)
隐式链接写法,先定义部分链接,然后通过[链接名称]
来加入链接,全文任何地方都可以使用
隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 "Google" 链接到 google.com,你可以简化成:
[Google][]
然后定义链接内容:
[Google]: https://www.google.com.hk/
由于链接文字可能包含空白,所以这种简化型的标记内也许包含多个单词:
Visit [Daring Fireball][] for more information.
然后接着定义链接:
[Daring Fireball]: http://daringfireball.net/
链接的定义可以放在文件中的任何一个地方,我比较偏好直接放在链接出现段落的后面,你也可以把它放在文件最后面,就像是注解一样。
下面是一个参考式链接的范例:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: https://www.google.com.hk/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
如果改成用链接名称的方式写:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: https://www.google.com.hk/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
实际效果如下:[google]
[google]: https://www.google.com.hk/ "Google"
定义链接跳转
[google]: https://www.google.com.hk/ "Google"
图片
在 Markdown 中,插入图片不需要其他按钮,你只需要使用![](图片链接地址)
这样的语法即可,
例如:
注:插入图片的语法和链接的语法很像,只是前面多了一个!
。
插入链接和图片的案例截图:
引用
在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上>
就好了,例如:
> 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
注:>
和文本之间要保留一个字符的空格。
最终显示的就是:
一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
引用的案例截图:
粗体和斜体
Markdown 的粗体和斜体也非常简单,用两个*
或者 _
包含一段文本就是粗体的语法,用一个*
或者 _
包含一段文本就是斜体的语法。例如:
*一盏灯*, 一片昏黄;**一简书**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
最终显示的就是下文,其中「一盏灯」是斜体,「一简书」是粗体:
一盏灯, 一片昏黄;一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
_一盏灯_, 一片昏黄;__一简书__, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
一盏灯, 一片昏黄;一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
\*this text is surrounded by literal asterisks\*
粗体和斜体的案例截图:
代码引用
需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。如果引用的语句为多行,可以将```置于这段代码的首行和末行。代码引用的案例截图:
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段:
``There is a literal backtick (`) here.``
实际效果:There is a literal backtick (`) here.
代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样你就可以在区段的一开始就插入反引号:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
实际效果:
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`
表格
相关代码:
| Tables | Are | Cool |
| --------------|:-------------:| -----:|
| col 3 is | right-aligned | $1600|
| col 2 is | centered | $12|
| zebra stripes | are neat | $1|
显示效果:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
相关代码:
dog | bird | cat
----|------|----
foo | foo | foo
bar | bar | bar
baz | baz | baz
显示效果:
dog | bird | cat |
---|---|---|
foo | foo | foo |
bar | bar | bar |
baz | baz | baz |
显示链接中带括号的图片
代码如下:
![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1