Markdown
Markdown
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
段落之间空一行。同一段落不同行,在行结束时输入两个空格(换行符)。
标题
标题有6个等级,对应#,##,...######,后面最好有一个空格,一般使用前3级。
# 这是第一级,文章的标题
## 这是第二级,文章主要部分的大标题
### 这是第三级,二级标题下面一级的小标题
#### 这是第四级,谨慎使用四级标题,尽量避免出现,保持层级的简单和防止出现过于复杂的章节。
效果:
这是第一级,文章的标题
这是第二级,文章主要部分的大标题
这是第三级,二级标题下面一级的小标题
这是第四级,谨慎使用四级标题,尽量避免出现,保持层级的简单和防止出现过于复杂的章节。
列表
无序列表(-//+跟着1+个空格,推荐用)
* *开头
- -开头
+ +开头
效果:
- *开头
- -开头
- +开头
有序列表(数字跟着英文句点再跟1+个空格)
1. 正常1.开头,一个空格即可
2. 这里有多个(3个)空格也是可以的
2. 有序列表的数字不用在意顺序,这里还是2.也是可以的
3. 列表(有序或无序)的行之间
最好有缩进(4个空格比较美观),
也可以没有缩进。
这是第二段。列表多个段落的行首,必须有缩进。
行首出现数字加句点,需要使用\进行转义:
1987\. What a great season
效果:
-
正常1.开头,一个空格即可
-
这里有多个(3个)空格也是可以的
-
有序列表的数字不用在意顺序,这里还是2.也是可以的
-
列表(有序或无序)的行之间
最好有缩进(4个空格比较美观),
也可以没有缩进。这是第二段。列表多个段落的行首,必须有缩进。
行首出现数字加句点,需要使用\进行转义:
1987. What a great season
文本样式
**2个\*包住的内容会加粗**
*1个\*包住的内容会斜体*
~~2个\~包住的内容会删除线~~
效果:
2个*包住的内容会加粗
1个*包住的内容会斜体
2个~包住的内容会删除线
分割线
多种方式表示分割线,推荐3个*表示,简单
星号*,3+个,中间可以或者不插入空格
减号-,3+个,中间须插入1+个空格( 推荐多个减号,比较像分割线)
底线_,3+个,中间不能插入空格
****
* * *
- --
___
效果:
星号*,3+个,中间可以或者不插入空格
减号-,3+个,中间须插入1+个空格( 推荐多个减号,比较像分割线)
底线_,3+个,中间不能插入空格
链接
行内式
[我的网站](http://biaoqianwo.com)
这是[MarkDown入门指南](http://www.jianshu.com/p/1e402922ee32/)
![这是选填的alt](http://note.youdao.com/favicon.ico "这是选填的title")
效果:
这是选填的alt参考式
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
[1]: http://google.com/ "Google Search"
[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]:http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/
[msn]: http://search.msn.com/ "MSN Search"
链接内容定义的形式为:
- 方括号(前面至多三个空格来缩进),里面输入链接文字
- 接着一个冒号
- 接着0+个空格
- 接着链接的网址
- 接着选填的title,可以用双引号或括弧包着
效果:
I get 10 times more traffic from Google than from Yahoo or MSN.
等同于行内式写法:
I get 10 times more traffic from [Google](http://google.com/ "Google") than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or [MSN](http://search.msn.com/ "MSN Search").
引用
一般引用
>以>开头的内容
>>多>就是引用的嵌套
效果:
以>开头的内容
多>就是引用的嵌套
多行引用
多行引用并不需要每一行都有>(首行必须有>,github上要求每行结尾2个空格,jianshu不要求)
>窗前明月光
疑是地上霜
举头望明月
低头思故乡
效果:
窗前明月光
疑是地上霜
举头望明月
低头思故乡
代码
单行代码
`hello world`
效果:
hello world
``如果要在代码区段内插入反引号`,可以用多个反引号`包住``
效果:
如果要在代码区段内插入反引号`,可以用多个反引号`包住
多行代码
```
<?php
function helloWorld(){
echo "Hello world!";
}
```
效果:
<?php
function helloWorld(){
echo "Hello world!";
}
反斜杠
以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
表格
第一行是表头,第二行表示对齐,“-”2个+即可
|Id|Name|Price|
|:--|:--:|--:|
|1|白菜|1.5|
|2|胡萝卜|1|
|3|猪肉|15|
|左对齐|居中|右对齐|
效果:
Id | Name | Price |
---|---|---|
1 | 白菜 | 1.5 |
2 | 胡萝卜 | 1 |
3 | 猪肉 | 15 |
左对齐 | 居中 | 右对齐 |
简写链接和邮件地址,用<>包住
<http://example.com/>
<address@example.com>
效果:
http://example.com/
address@example.com
编辑器
注意
github、有道云笔记、简书对Markdown的支持和显示效果略有差异:
本文在github的地址。
本文在有道云笔记的地址
本文在简书的地址