Markdown

 

Markdown简介

wiki释义:

Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）和亚伦·斯沃茨（Aaron Swartz）。 它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档”。 这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

Markdown的优点包括但不限于以下几点:

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

Markdown语法

Markdown语法简洁明了、容易学习，下面一一介绍。

基本符号

• *, - , +： 这3个符号的效果都一样， 被称为Markdown符号
• 空白行 : 表示另起一个段落,对应HTML中的 <p> 元素
• ` 表示 内联代码， tab是用来标记代码段，分别对应HTML的 <code> ， <pre> 元素

段落换行

• 单个回车会被解释为空格
• 一个空白行(即两个回车)变成单一段落<p>
• 连续3个Markdown符号，然后回车，表示<hr>横线
• 连续多个空格会被解释为单个空格

标题

• 在文字前面加上1-6个#来实现, 代表HTML中的六级标题 h1-h6

• 在文字左右各加1-3各符号，可本别实现斜体<i>、加粗<b>和斜体加粗

  # 一级标题
  ## 二级标题
  ### 三级标题
  #### 四级标题
  ##### 五级标题
  ###### 六级标题
  
  *斜体*
  
  **加粗**
  
  ***加粗斜体***
  

  效果如下:

  一级标题

  二级标题

  三级标题

  四级标题

  五级标题

  六级标题

  斜体

  加粗

  加粗斜体

引用

• 在第一行加上 > 和一个空格，表示引用，还可以嵌套, 对应HTML中的<blockquote>标签

列表

• 使用*,+,-加上一个空格来表示,对应HTML中的<ul>标签
• 可以支持嵌套
• 有序列表用 数字+.+空格 来表示,对应HTML中的<ol>标签

• 如果列表内容很长，不需要手工输入换行符，css控制段落的宽度，会自动的缩放的

  **无序列表:**
  
  - 无序列表 1
  - 无序列表 2
  - 无序列表 3
  
  **有序列表:**
  
  1. 有序列表 1
  2. 有序列表 2
  3. 有序列表 3
  
  **列表嵌套:**
  
  - One
      + What
      + Why
      + How
  - Two
  - Three
  

效果如下

无序列表:

• 无序列表 1
• 无序列表 2
• 无序列表 3

有序列表:

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3

列表嵌套:

• One
  • What
  • Why
  • How
• Two
• Three

链接

在 Markdown 中，插入链接只需要使用 [显示文本](连接地址)这种格式， 插入图片只需要使用![图片描述](图片链接地址)这种格式即可,其中前者对应于 HTML中的a标签，后者对应img标签，方括号中的图片描述为img标签的的alt属性值

还有一种建立链接的方式，称为参考式, 参考式的链接是在链接文字的括号后面再接上另一个方括号， 而在第二个方括号里面要填入用以辨识链接的标记: [显示文本][id]或![图片描述][id]. 接着，在文件的任意处，你可以把这个标记的链接内容定义出来：[id]: http://example.com/

示例:

个人信息:

[Wentong](http://www.fangwentong.com/)

- [GitHub][1]
- [Facebook][]
- [Twitter][Weblog]

[1]: https://github.com/fangwentong/
[Facebook]: https://facebook.com/fangwentong/
[Weblog]: https://twitter.com/fangwentong/

效果如下:

个人信息:

Wentong

• GitHub
• Facebook
• Twitter

表格

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

特殊符号

• 用\ 来转义，表示文本中的markdown符号

兼容HTML语法

我们知道，Markdown最终要通过Markdown解释器转换为HTML文档, 而Markdown是一种书写的格式，它的语法种类很少，只对应HTML标记中的一小部分, 不在Markdown涵盖范围内的标签， 可以直接在文档中用HTML书写.

自定义Markdown样式

注意到，Markdown解释器将Markdown文本转换为HTML文档，我们编写CSS，并在生成的HTML文档中引用这个样式表， 可以达到自定义Markdown显示风格的效果.

几个好用的Markdown工具

• Chrome扩展 -- 马克飞象
• Chrome插件 -- Markdown-here 用Markdown写一封漂亮的电子邮件.
• Mac平台, 推荐使用Mou
• Chrome插件 -- Markdown Preview Plus , 实时预览网络或者本地Markdown文档.

参考文章：

1. 官方文档(中文版)：Markdown 语法说明
2. 鲁塔弗：markdown 简明语法
3. 简书：献给写作者的 Markdown 新手指南

markdowncheatsheet Updated on June 03, 2014 fangwentong

 

 

 

[b]Markdown for GitHub[/b]

[code=markdown]
<ruby>梯<rp>(</rp><rt>fan</rt><rp>)</rp>子<rp>(</rp><rt>qiang</rt><rp>)</rp></ruby>
[/code]

 

 

 

http://blog.wentong.me/2014/06/markdown-cheatsheet/