关于Markdown

Markdown的基本语法

Posted by iMaple on May 18, 2016

相信接触过 github 的你肯定看过这样一个文件:README.md,没错,这就是一个markdown文件。markdown 只是作为一种轻量级的标记语言,它的出现备受广大写作爱好者的青睐,能让你在写博客的时候逼格更高的同时更多地专注于文章内容本身。markdown 的特点就是 ‘易读易写’且‘兼容部分html标签’,常用语法不超过10个,所以说学习成本是非常低的。

一、基础语法

1. 标题

markdown 对标题的写法有两种:

  • 类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),其中 = 和 - 的数量没有限制要求,eg:
主标题(一阶标题)
===

副标题(二阶标题)
---

效果:

主标题(一阶标题)

副标题(二阶标题) —

  • 类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,eg:
#  一级标题
##  二级标题
###  三级标题
####  四级标题
#####  五级标题
######  六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 区块引用

当你需要引用到别处的文章时可用到,只需要段落前加一个 > 符号即可,eg:

> 注:这里是引用

效果:

注:这里是引用


3. 代码块

和代码相关的,我们一般希望跟普通文本区分开,这时候便需要用到代码块的标记包起来,用法也很简单,特殊字段我们在其两侧各用一个反单引号 ` 包起来即可,对于整段的代码,我们则是在段落前后各用三个反单引号包起来即可,或者用四个空格开始,后面的代码就会自动变成代码块包起来了,eg:

这里是 `imaple` 的博客

效果: 这里是 imaple 的博客

``` 
var me = '林鉴伟';
alert(me);
``` 

效果:

 var me = '林鉴伟';
 alert(me);

4. 列表

罗列信息时就需要用到列表标签,同样分为 有序列表无序列表 两种,eg:

1. 列表项1
2. 列表项2
3. 列表项3

效果:

  1. 列表项1
  2. 列表项2
  3. 列表项3
- 列表项1
- 列表项2
- 列表项3

效果:

  • 列表项1
  • 列表项2
  • 列表项3

5. 链接地址

顾名思义,就是html里的a标签啦,语法为

[链接文字](链接地址)

eg:

我的博客地址,请猛戳 -> [小林的博客](http://imaple.net)
或
我的博客地址,请猛戳 -> <a href="http://imaple.net">小林的博客</a>
另:
简单的链接还能这样:<http://imaple.net>

效果:

我的博客地址,请猛戳 -> 小林的博客 另: 简单的链接还能这样:http://imaple.net


6. 图片引用

用法与链接地址类似,语法为

![链接文字](链接地址)(注意最前面有个 `!` 号)

eg:

![迷の微笑](http://o83pigran.bkt.clouddn.com/16-6-2%2F46804377.jpg)
或
<img src="http://o83pigran.bkt.clouddn.com/16-6-2%2F46804377.jpg"/>

效果:

迷の微笑


7. 文本强调

对一些关键字,我们要起到强调的效果好引起读者注意的,我们可以在文本两侧各用 *_ 包起来以达到 斜体 的效果,或者在文本两侧各用 **__ (两个下横线) 包起来以达到 加粗 的效果。同样的,html中的 <strong><b><i><em><big><mark> 等标签在这里也同样适用。


8. 分割线

段落与段落间,可以用 ***___ 表示一条分割线,eg:


9. 其他

9.1 回车

一个回车表示换行 两个回车表示换段 多个回车没有用

9.2 段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

Again:一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

多个空行也只解析为一个空行。

9.3 表格

表格的语法简直恶心人。。。

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

二、markdown 编辑器

这里用了 简书 来在线编辑,感觉效果还挺ok的,有道云笔记 也差不多吧,其他没用过,就只推荐这两款了。


三、图床选择

如果项目中图片资源的大小跟数量都不大的话,则忽略这一步,反之可以选择一个图床来存储图片资源,这里试过了好多,还是推荐 七牛云存储, 其他的不是只有试用一个月就开始收费,就是空间不大或者操作界面不友善,七牛用着还算ok啦,这里推荐一下。

四、疑问

这里记录一些我遇到或还没有解决的问题,希望知道答案的朋友在留言里告知一下,感激不尽~

1、插入图片时默认会居中,这时候要怎么给插入的图片来添加样式???

2、标示特殊字段的代码块如果包含特殊字段应如何表示?比如:

想标示一个 反单引号 如果用 ``` 表示会出现解析错误,网上说用\可以插入特殊字符,可我试了没效果,郁闷死。。。