Markdown语法简介
让你的写作如行云流水
导语
Markdown是一种轻量级的标记语言,类似HTML,但是要比HTML简单多得多,据说5分钟就可以完全掌握所有的语法,而我用了将近两天的时间整理这份文档,也许是到处找资料过于追求完美的缘故吧。文中包含了网上搜集到的包括官网和写作爱好者总结的所有关于Markdown的语法。格式是用了分门别类的方式,个人感觉这样比较容易理解和记忆,方便以后查阅和入门的小伙伴们的参考,如有误差的地方望指正。
1、标题
分类:
1. 类setext
2. 类atx
类setext
语法:
以单下划线和双下划线的方式标记,双下划线就是一级标题,单下划线就是二级标题(单、双下划线的数量不限)。
示例:
一级标题
=======
二级标题
———-
类atx
语法:
以标题前面’#’号的个数区分标题的等级,从1个’#’到6个’#’分别代表1~6级标题,等级越高字体越小,为了美观也可以在标题的末尾加上同等数量的’#’号,但这纯粹是为了对称美观
示例:
#一级标题#
##二级标题##
###三级标题###
####四级标题####
#####五级标题#####
######六级标题######
2、区块引用
语法:
每一行前面加上’>’符号,也可以以偷懒的方式,只在段落的第一行前面加上’>’
示例:
>这是引用文字
特点:
1. 区块标记可以嵌套
示例:
>这是引用文字
>>这是一层嵌套引用
>>这是二层嵌套引用
2. 引用的区块内可以使用其他的Markdown语法
示例:
>引用文字*强调文字*
3、列表
分类:
1. 有序列表
2. 无序列表
无序列表
语法:
在文本前加’*’或者’+’或者’-‘符号
示例:
* 列表行一
* 列表行二
+ 列表行一
+ 列表行二
- 列表行一
- 列表行二
有序列表
语法:
数字后面紧跟着英文句号的方式生成有序列表
示例:
1. 列表行一
2. 列表行二
4、代码区块
语法:
在行首添加一个制表符或者四个空格就可以生成代码区块的样式,代码区块其实就是编写的文本会被一个边线框包围
示例:
(一个制表符或者四个空格符)代码区块
注意:
代码区块内的Markdown的语法失效,会以普通字符输出,内部的代码样式不会改变,这也正是代码区块的特点所在
5、分割线
语法:
三个以上的星号或者减号或者底线符号生成分割线
示例:
**** 或者 * * * *
— 或者 - - -
___ 或者 _ _ _
注意:
星号,减号和下划线中间可以穿插任意多个空格,但不能有其他字符
6、链接和图片
分类:
1. 行内式
2. 参考式
行内式
语法:
[链接文字](链接 可选链接”Title”)
示例:
[百度首页](http://www.baidu.com “百度首页”)
注意:
如果是本机资源链接可以使相对路径
参考式
语法:
[链接文字][链接标示],然后你就可以在文章的任意地方通过链接标示定义链接内容
链接内容定义格式:
[链接标示]: 链接网址 “链接标题”
示例:
[百度首页][a]
[a]: http://www.baidu.com “百度”
附:
链接标示为空的链接标记成为隐式链接标记
语法:
[链接文字][]
[链接文字]: 链接 “可选标题”
示例:
[百度首页][]
[百度首页]: http://www.baidu.com “百度”
注意:
链接标示方括号后面的冒号后面至少有一个空格,链接标题可有可无,链接标题可以用双引号,单引号或者小括号包围,效果相同。链接标示可以是字母,数字,空白和标点符号,但是不区分大小写。
7、图片
图片和链接十分类似,不同的是图片语法的前面多了个惊叹号,这里就不在浪费篇幅了,只列举两个例子
示例:
行内式:![占位文字](图片连接 “标题”)
参考式:![占位文字][图片标示id]
[图片标示id]: 图片地址 “标题”
8、强调(斜体和粗体)
分类:
1. 斜体
2. 粗体
斜体
语法:
文本被一对星号或者下划线符号包围
示例:
*斜体强调文字*
粗体
语法:
文本被两对星号或者下划线符号包围
示例:
**粗体强调文字**
注意:强调文字可以在一句话内使用也可以单独使用
9、标记代码
语法:
代码部分用反引号包围(反引号就是数字1前面的按键),如果代码中包含反引号,可以用双反引号包围代码
示例:
`[btn setTitle:str forState:UIControlStateNormal];`
10、其他语法
输入空格
简介:
在Markdown中直接输入单个空格是可以的,但是连续输入多个空格就不行了,结果和输入一个空格是一个效果,那么怎么连续输入多个空格呢?语法如下
语法:
切换输入法为全角输入模式
换行
简介:
Markdown中想要换下一行输入文本,直接回车是不行的,效果和输入tab是一样的,需要用特殊的语法
语法:
首先敲两个空格,然后再回车
输入空行
简介:
在平常的写作中,为了格式的协调经常要输入空行,和输入空格一样,Markdown中单独输入单行空行可以用回车,但是要连续输入多行空行还需要特殊的语法
语法:
\
注意:
因为Markdown兼容HTML,所以这里其实用的是HTML的语法
输入小型文本
简介:
这里所说的小型文本就是输入的文字比普通的文字要小
语法:
用small标签包围文本
示例:
\这是小型文本\
注意:
小型文本语法其实是运用了HTML的语法
文本中间划线
语法:
文本用三对’~’包围
示例:
~~~操作文本~~~
自动链接
简介:
网址和邮箱可以点击自动跳转到浏览器打开
语法:
<网址或邮箱>
示例:
\http://www.baidu.com \address@163.com
反斜杠转意
简介:
这个类似代码里面的转意字符,可以把语法字符转换成普通字符显示
示例:
#这个不作为标题
11、插入表格(扩展语法)
语法:
找了好久也没有找到表格语法的描述,就只有示例里面的两个示例,好纳闷,也许解释起来比较费劲吧,那就照葫芦画瓢凑合着用吧,毕竟我也是刚入门,等以后深入了解了再更新
示例:
| 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
12、其他相关资料
语法参考手册
工具
这里推荐使用mac上非常好用的工具软件Mou,说好用其实是因为它完全免费,因为我知道收费的软件你肯定不会用_^ ^_,何况这只是一款用于写作的软件呢。你可以点击这里下载,点击这里进入Mou官方网站了解详情。