Markdown语法介绍
虽然Markdown的语法已经足够的简单和容易,但是在不经常使用的情况下,还是会记不住具体的语法,本文主要对Markdown常用的一些语法进行简单的罗列,以期望下次忘记的时候可以快速的进行查阅。
Markdown的目标是实现[简单易读]。 Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。
一 区块元素
1 段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。
2 标题
(1)使用底线的模式
使用 “=” 来标识最高阶标题
例:一级标题
=======
(2)在文字之前使用 1到6 个 “#” 来标识标题 1个代表最高阶标题,一次往下递减
例如:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
3 区块引用 Blockquotes
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。
这是一个区块引用
这是一个区块内的引用
在同一个地方多次使用 ">" 就会引用在同一个区块中
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
空山新雨后,
天气晚来秋,
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :
我是最外层的应用
我是加了两层的引用
我是加了第三层的引用,多加几个 > 引用就会越往里
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
我是一个在引用内的标题 我的格式是 “ > ### ”
4 列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
(1)"+"号的无序列表(格式:"+ 想显示的文字")
- 红色
- 蓝色
- 黄色
(2)""号的无序列表(格式 : " 想显示的文字")
- 红色
- 蓝色
- 黄色
(3)"-"号的无序列表(格式:"-" 想显示的文字)
- 红色
- 蓝色
- 黄色
以上三种格式最终显示出来的效果是一致的,所以可以根据自己的喜好选择对应的编写
有序列表则使用数字接着一个英文句点:(格式: “x. 想显示的文字” )
- red
- blue
- yeallow
如果要在列表项目内放进引用,那 > 就需要缩进:
- 颜色
蓝色
黄色
蓝色
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
- 这是一个代码区块:
<代码可以写在这里>
5 代码区块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如:
这是一个段落
这是一个代码区块
这是代码区块
6 分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
以下是创建分割线的各种方式:
******
-----
* * *
________
一 区段元素
1 链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。(格式:" [链接中文名字] (链接英文名字) " 注:方括号与圆括号之间不能存在空格)
2 强调
Markdown 使用星号""和底线"_"作为标记强调字词的符号.(格式: “ 要强调的内容 *”)
这是使用星号要强调的内容
这是使用底线强调的内容
唯一的限制是,你用什么符号开启标签,就要用什么符号结束。
3 代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`)
例如: 如下的内容包含了一个 'printf()'的代码段
4 图片
格式:(![图片名称] (图片地址)) 注:方括号与圆括号之间在写的时候是没有空格的,这里只是为了能展示出来,所以添加了对应的空格.
例:
唯美图片
如果是想直接显示图片的话,在简书中有插入图片的输入,可直接插入一张图片。
4 反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号.
至此,一篇简单的文档就可以使用Markdown来编写完成的。当然这些只是简单浅显的利用,还有许多Markdown的功能未能罗列。可参考具体的Markdown使用文档