Markdown作为一种使用普通文本编辑器编写的标记语言,通过简单的标记语法,设置文本不同的格式。以实现 [易读易写] 的目标。
Markdown为编写HTML提供了很好的实现,并避免了伴随的复杂性和丑陋难看。Markdown的语法全由一些符号组成,语法简单易上手。
本文介绍Markdown语法入门。
一、语法介绍
1.1 标题
1.1.1 Setext形式
类Setext形式是用底线的形式,利用 =
(最高阶标题) 和 -
(第二阶标题),例如:
This is H1
===========
This is H2
-------------------
This is H1
This is H2
注意:其中,任何数量的 =
和 -
都是等效的。
1.1.2 Atx形式
类Atx形式是在行首插入 1 到 6个 #
,对应分别为标题 1
到 6
阶,例如:
# H1 #
## H2 ##
### H3 ###
#### H4 ####
##### H5 #####
##### H6 #####
H1
H2
H3
H4
H5
H6
通常,若为了美观用,可以在行尾加上 #
,行尾的 #
不强制要求和开头一样,只有行首的字符数确定标题对应的阶数。
1.2 区块引用Blockquotes
Markdown 标记区块引用类似email中用 >
的引用方式。在每行的前面加上 >
。
同样,Markdown允许只在整个段落的第一行最前加上 >
。
区块引用也可以嵌套,根据不同层次加上不同数量的 >
即可。
引用的区块内同样可以使用其他Markdown 语法,包括标题,列表,代码区块等
。
> 区块引用...
>
> 区块引用...
> 段落只需要要在第一行加上
整个段落即引用在区块内。
> 区块间引用
>> 区块间引用
> ### 引用其他语法
区块引用...
区块引用...
段落只需要要在第一行加上
整个段落即引用在区块内。
区块间引用
区块间引用
引用其他语法
1.3 列表
Markdown支持有序列表和无序列表。
1.3.1 有序列表
有序列表使用1.
数字接着一个英文句点;特别注意的是在标记上使用的数字并不会影响输出结果;列表项还可以包含多个段落,每个列表下段落都必须缩进4个空格或者1个制表符;如果需要在列表项目内引用的时候,使用 >
需要缩进。例如如下语法:
1. item 1
3. item 2(标记上使用的数字并不会影响输出结果)
2. item 3(标记上使用的数字并不会影响输出结果)
4. item 4
多段文字1
多段文字1
>区块引用
5. item 5
1.列表项目内加列表
- item 1
- item 2(标记上使用的数字并不会影响输出结果)
- item 3(标记上使用的数字并不会影响输出结果)
- item 4
多段文字1
多段文字1区块引用
- item 5
1.列表项目内加列表
1.3.2 无序列表
无序列表使用 *
(星号)、+
(加好) 以及 -
(减号)作为列表标记:
- item 1
+ item 2
* item 3
- item 3.1
- item 3.1.1
- item 1
- item 2
- item 3
- item 3.1
- item 3.1.1
- item 3.1
1.4 代码区块
和程序相关的写作通常会用到代码区块,如果用区块引用排版就会和代码排版有差异,而我们更希望是按照原来的样子显示。Markdown 通过 <code>`</code> 和 <code>```</code> 标签来把代码区块包起来。
在代码区块里, &
、<
和>
会自动转换成HTML试题,这样让诸如插入范例使用的HTML原始码更方便了。
<div class="footer">
© 2004 Foo Corporation
</div>
在代码区块中,一般的Markdown语法不会被转换,因此可以很容易的用Markdown语法撰写相关语法文档。
1.5 分割线
在任意一行中用三个以上的 *
、-
以及_
来建立分割线,行内不能有除空格
外的其他内容。
1.6 特殊格式
1.6.1 粗体
粗体文字设置使用 **
将目标文字包含起来。
Bold
1.6.2 斜体
斜体文字设置使用 _
将目标文字包含起来。
Italics
1.6.3 删除线
斜体文字设置使用 ~~
将目标文字包含起来。
strikethrough
1.6.4 语法高亮
特定语法用如<code>```js</code>将设置超链接的文字包含起来。
grunt.initConfig({
assemble: {
options: {
assets: 'docs/assets',
data: 'src/data/*.{json,yml}',
helpers: 'src/custom-helpers.js',
partials: ['src/partials/**/*.{hbs,md}']
},
pages: {
options: {
layout: 'default.hbs'
},
files: {
'./': ['src/templates/pages/index.hbs']
}
}
}
};
1.7 表格
1.7.1 普通表格
表格通过 |
和 -
表示。表头需要和表内容用 -
分割,各列内容用 |
分割。注意,不需要垂直对齐。
|table1|table2|
|--------|-------|
|content1|content2|
table1 | table2 |
---|---|
content1 | content2 |
1.7.1 特殊格式表格
在表头内容分割线结束加上 :
即表示文字靠右对齐。
|table1|table2|
|--------:|-------:|
|content1|content2|
table1 | table2 |
---|---|
content1 | content2 |
1.8 超链接
超链接通过 [ 超链接文字 ]
包含超链接文字内容,并在后紧跟 (URL)
超链接地址。
[Link](http://www.jianshu.com/u/7f8d85055cd1)
当需要为超链接添加hover效果的时候,在 (URL "hoverTitle")
URL后用 ""
将提示文字包含起来。
[Link](http://www.jianshu.com/u/7f8d85055cd1 "Burjal")
1.9 Named Anchors
Named Anchors使能够在相同的页面上跳转到指定的锚点。最常用的就是跳转到每一个章节。
# Table of Contents
* [Chapter 1](#chapter-1)
* [Chapter 2](#chapter-2)
* [Chapter 3](#chapter-3)
Table of Contents
上述会跳转到对应如下位置:
## Chapter 1 <a id="chapter-1"></a>
Content for chapter one.
## Chapter 2 <a id="chapter-2"></a>
Content for chapter one.
## Chapter 3 <a id="chapter-3"></a>
Content for chapter one.
1.20 图片
图片的语法和超链接的语法类似,在超链接语法前加了 !
。
![Markdown](http://upload-images.jianshu.io/upload_images/311578-26c2869134c4e359.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
二、简书设置默认编辑器:
简书已经支持Markdown语法编辑。
设置步骤如下:
在首页找到并进入设置。
将常用编辑器设置为 Markdown
。
Markdown 语法入门分析到此就结束了~
附: