发布于 2015-12-13 08:57:04 | 239 次阅读 | 评论: 0 | 来源: PHPERZ
这里有新鲜出炉的Markdown 语法说明,程序狗速度看过来!
Markdown 轻量级标记语言
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如joomla、drupal都能很好的支持Markdown。
Markdown 是一种轻量级的标记语言,其用简单的标记语法便可达到排版的目的,其可以使我们更加专注于内容的编写,而不需过多关注排版。本文主要整理了 Markdown 中的常用的标记语法,以便自己与他人以后查用。
Markdown 中的段落指连续的一段文字,编写时段落之间用至少一个空行隔开,段落内多个空格将被视为一个空格,段首不支持缩进。
如果想要在显示时显示多个空行,可以插入 <br/>
来实现,注意的是,插入的 <br/>
应与前后的段落中间至少空一行。
Markdown 支持两种类型的标题。
//类型 1
这是一级标题
==========
这是二级标题
----------
//类型 2
# 这是一级标题
## 这是二级标题
...
###### 这是六级标题
从上面可以看出类型 1 是在标题下面插入 =
或者 -
来标识标题等级,但局限是其只能表示两个级别的标题。
类型 2 是在标题前面插入 1 - 6 个 # ,表示 6 个等级的标题,这是比较推荐的用法。
Markdown 中使用 >
来引用。我们可以在一段文字中的每行开头加上 >
来表示一段引用文字,也可以只在一段文字的开头插入一个 >
来表示,如下面的 1、2 两种方式:
//方式 1
> 这是一句话
> 这是第二句话
//方式 2
> 这是一句话
这是第二句话
Markdown 支持使用不同数量的 >
表示嵌套引用。
> 这是外层的引用
> > 这是内层的引用
无序列表使用 -
、 +
或 *
来作为标记。
- 第一项
- 第二项
- 第三项
上面的 -
可以用 +
、 *
替换。需要注意的是,-
等符号与后面的文字至少空一格空格。
有序列表使用数字和紧挨着的点号表示。
1. 第一项
2. 第二项
3. 第三项
同无序列表一样,标记符号与后面的文字至少空一格空格。但编辑时的数字对显示无影响。
2. 第一项
6. 第二项
1. 第三项
上面的例子与前一个显示的结果完全一致,但建议编辑时按照数字顺序。
有序列表和无序列表的每一项中均可嵌套其他列表;
在列表项之间要插入段落时,这时需要将列表项之间的段落缩进 4 个空格;
使用 1\.
来输出 1.
;
缩进 4 个空格,需要注意的是,每行代码都需要至少缩进 4 个空格,不能像段落一样采用首行标记的偷懒写法,一个代码区会一直持续到没有缩进 4 个空格的那一行。
也可以用一对三个连续的撇号 `
来包裹代码段。
使用三个及以上的 *
、 -
或 _
来表示一个分割线,符号不能混用,符号之间可以插入多个空格。需要注意的是,使用 -
来插入分割线时需要与上一个段落至少空一行,否则 Markdown 会将上一行文字解释为二级标题。
表格是 Markdown 比较复杂的一种表示。
| Table | Col1 | Col2 |
| ----- |:----:| ----:|
| Row1 | 1-1 | 1-2 |
| Row2 | 2-1 | 2-2 |
| Row3 | 3-1 | 3-2 |
上面第二行中的点代表对齐方式,分别是默认(居右)、居中、居左。
Markdown 中有三种方式实现超链接。
//方式 1
[百度](http://www.baidu.com)
//方式 2
[百度][Baidu-url]
方式 1 较为常用,也可以为链接的文字加上提示文字,只要在括号中超链接加上空格后添加提示内容即可。
[百度](http://www.baidu.com "这是提示文字")
方式 2 由链接文字和链接地址组成,不同的是两者均由 []
包裹。链接地址的格式为:
方括号,里面输入链接地址;
紧接着是一个冒号;
冒号后面至少一个空格;
链接地址;
若有提示文字,空格后用引号或者括号包裹提示文字。
下面是完整示例:
[百度][Baidu-url]
[Baidu-url]: http://www.baidu.com "这是提示文字"
第三种方式是用 <>
来包裹 URL。
//方式 3
<http://www.baidu.com>
Markdown 使用 *
和 _
来表示粗体和斜体。
//加粗
**这是加粗文字**
__这也是加粗文字__
//斜体
*这是斜体文字*
_这也是斜体文字_
被偶数个 *
或 _
包裹的文字显示加粗效果,被奇数个包裹的为倾斜效果。
需要注意的是,*
和 -
要成对出现,不能混合使用,也不能只出现一个。同时,标识符号要与标识的文字紧挨着,符号与符号之间、符号文字之间不能有任何空格。
使用 `
(撇号) 来包裹一小段代码。
`Hello world.`
若想在代码中添加撇号,可以使用多个撇号包裹里面需要添加的撇号,但注意里面的连续的撇号数量不能超过外面的数量。
//显示一个撇号
`` ` ``
//显示两个撇号
``` `` ```
图片的插入方式跟超链接前两种插入方式类似。
//方式 1
![如果图片不能显示,就显示这段文字](图片 url)
//方式 2
![如果图片不能显示,就显示这段文字][Image-url]
\
我们经常需要在文章中插入一些特殊符号,而这些符号恰好是前面所讲的标识符号,可以在特殊符号前插入 \
来直接显示符号,而不让 Markdown 来将其解释为标识符号。
Markdown 支持以下这些符号前插入 \
而显示其本来样子:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
Windows 环境下,推荐 Markdownpad,自带图床功能;
Mac 环境下,推荐 Mou;
笔记软件: 为知笔记较好的支持 markdown,且支持 Windows、Mac、web、ios、android 等各个平台。