markdown常用语法说明

Feb 23, 2016


markdown概述


维基百科上是这样解释markdown的:markdown是一种轻量级标记语言,它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML或者HTML文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

像使用jekyll搭建的博客中,就支持markdown语法来更新博文;在github里,可以使用markdown的一个分支版本来格式化评论、消息以及其他内容。

Markdown 具有以下优点:

  • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  • 让你专注于文字而不是排版。
  • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
  • Markdown 的标记语法有极好的可读性。

markdown常用语法


  本文记录下我在用markdown编辑文件时常用的语法,效果图可以自行在markdown编辑器中查看。

块区元素

  区块元素包括标题、列表、区块引用、代码区块、段落、表格和分割线。


标题

标题是通过在文本前面加上#来实现的;

例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了;

例如:

- 文本1
- 文本2
- 文本3

如果你希望有序列表,也可以在文字前面加上 1. 2. 3. 就可以了;

例如:

1. 文本1
2. 文本2
3. 文本3

注:-、1.和文本之间要保留一个字符的空格。

区块引用

Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了;

例如:

> 这是一段区块引用

注:> 和文本之间要保留一个字符的空格。

代码区块

插入代码的方式有两种

  1. 在每行代码前加入4个空格或者添加一个制表符(TAB键)
  2. 在代码两侧添加三个反引号‘```’。
  3. 如果想标记一小段行内代码,可以用反引号`把它标记起来;

段落和换行

一个markdown段落是有一个或多个连续的文本行组成,它的前后要有一个以上的空行;

如果想要依赖markdown来插入
标签的话,在插入处先按入两个以上的空格然后回车;

表格

相关代码:

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

分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减 号中间插入空格。下面每种写法都可以建立分隔线:

* * *

***

*****

- - -

---------------------------------------


区段元素

  区段元素包括链接、强调、图片和空格;


链接

在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址) 这样的语法即可,例如:

[简书](http://jianshu.io)

图片

使用 ![](图片链接地址) 这样的语法表示添加图片,例如:

![](http://ww4.sinaimg.cn/bmiddle/aa397b7fjw1dzplsgpdw5j.jpg)

强调

强调一般用斜体或者粗体来标记,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。例如:

*一盏灯*, 一片昏黄;**一简书**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

空格

加入 来输入一个空格.加入 &emsp来输入两个空格。

Markdown 免费编辑器


Windows 平台

Linux 平台

Mac 平台

在线编辑器

浏览器插件

高级应用

-Sublime Text 2 + MarkdownEditing /教程

参考链接


还有其他一些更加全面的关于markdown资料也可以学习


上一篇博客:使用git更新本地代码至github
下一篇博客:HTML&CSS基础1——选择器&文本样式