Markdown语法学习

Markdown使用教程

文中大部分摘抄自Markdown语法说明。本文的目的是笔者自己过一遍，写一遍加深印象。我用的平台是MarkdownPad2。

宗旨

Markdown的目标是实现”易读易写”。可读性和易写行。

兼容HTML

Markdown是一种适用网络的书写语言(这个下划线用到了HTML中的<u>)。可以兼容一部分HTML，目的是为了成为简易书写的格式。

可以直接在文档里面用HTML撰写，不需要额外标注这是HTML或者Markdown，只要加标签就可以了。

要制约的只有一些HTML区块元素——比如<div>、<table>、<pre>、<p>等，必须在前后加上空行与其他内容隔开。

        html     这是普通段落     <table>     <tr>            <td>FOO</td>        </tr>    </table>    这是普通段落

HTML的区段（行内）标签如<span>、<cite>、<del>可以在Markdown的段落、列表或者标题里随意使用。比如，丘吉尔说过：不想当将军的士兵不是好士兵（此处用到<cite>）。

Markdown语法在HTML**区块标签内失效，但在区段**标签内有效。

特殊字符自动转换

在HTML文件中，有两个字符串需要特殊处理：<和&。<符合用于起始标签，&符号用于标记HTML实体，如果你只是想要显示原型，必须使用实体的形式，&lt;和&amp&#59。

区块元素

段落和换行

一个Markdown段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来是空的）。普通段落不该用空格或制表符来缩进。

标题

Markdown支持两种标题的语法：类Setext和类atx形式。那么问题来了：什么是Setext？什么是atx？

Wikipedia上是如此说明Setext的：Setext is a lightweight markup language used to format plain text documents such as e-newsletters, Usenet posting, and e-mails.

atx的说明网页点击这里。

可见，两种都是结构化文本格式。

类Setext形式是用底线的形式，利用=（最高阶标题）和-（第二高阶标题），任何数量的=或-都会有效果，例如：

``这是H1======这是H2------``

类ATX形式是用1到6个#，比如：

``##我开始摇滚啦#####作词人###``

注意：一行的开始如果连续打4个空格，就会自动变为代码区。貌似现在也不用开头空两格，直接跟英文一样顶头写。

区块引用Blockquotes

Markdown标记区块引用是使用类似email中用>的引用方式。那会看起来像是你自己先断行，然后在每行的最前面加上>，也可以只在每个段落的开始加>，也可以嵌套。

``>this is a shoe ,>this is not only a shoe,>>this but also a hair dryer.My name is 007.Oh my god, my shoe's lose power,do you have some battery? So, a spy like you must be good at gun. Gun, I am not good at, what i good at is fly knife>>a strong wind come......>><font color="red">they stand up slowly</font>......``

显示效果如下：

this is a shoe ,
this is not only a shoe,

this but also a hair dryer.My name is 007.Oh my god, my shoe lose power,do you have battery? So, a spy like you must be good at gun. Gun, I am not good at, what i am good at is fly knife.

a strong wind come……
they stand up slowly……

引用区块也可以使用其他的Markdown语法，包括标题、列表、代码区块

列表

Markdown支持有序列表和无序列表。
无序列表使用星号、减号或者加号作为列表标记。

``* 周星驰* 张国荣* 吴孟达- 周星驰- 张国荣- 吴孟达+ 周星驰+ 张国荣+ 吴孟达``

显示效果一样的：

• 周星驰
• 张国荣
• 吴孟达
• 周星驰
• 张国荣
• 吴孟达
• 周星驰
• 张国荣
• 吴孟达

有序列表使用数字+英文句点+一个空格：

``1. 大拇指2. 食指3. 中指4. 无名指5. 小指头6. 有就恐怖了``

以下是显示效果：

1. 大拇指
2. 食指
3. 中指
4. 无名指
5. 小指头
6. 有就恐怖了

列表项目标记最多缩进3个空格。后面一定要跟一个空格。上面一定要空一个空行。

数字+句点+空白，等于一个序列了，注意。

代码区块

果然，只要简单的缩进4哥空格或是一个制表符，就可以简历代码区块：

this is a code block

markdown会转换成：

<pre><code>this is a code block</code></pre>

一个代码块会一直持续到没有缩进的哪一行。

代码块里面，就可以写代码，Markdown不会做任何解释处理。CSDN上面代码段显示行号，代码块´´´ ´´´包围。

分割线

三个以上的星号、减号、底线来简历一个分割线，行内不能有任何东西。

***-----___________

显示效果：

---

---

---

区段元素

待续。。。。晚安（2015.3.16 11pm）

链接

Markdown支持两种形式的链接语法：行内式和参考式两种形式。不管哪一种，链接文字都是用[方括号]来标记。

建立一个行内式的链接,只要在方括号后面紧接这圆括号并插入链接网址即可，

click [here](http://struts.apache.org/) to visit Struts2

显示效果：
click here to visit Struts2

建立一个参考式链接是在链接文字的括号后面在接上另一个方括号，而在第二个方括号里面填入用以辨识链接的标记。

This is [Struts2][struts] //接下来定义链接内容,后面的是title[struts]:http://struts.apache.org/ "Struts"

显示效果：

This is Struts2
//接下来定义链接内容,后面的是title

强调

Markdown使用（星号）和_（底线）作为标记强调字词的符号，被或包围的字词会被转成用<em>包围，用两个*或包起来的话，则会被转成<strong>。

 *what's up?* _what's up?_ **ok** **good**

显示效果：

what’s up?
what’s up?
ok
good

图片

代码

在一般的代码文字中，可以使用反引号来标记代码区段，区段内的&、<和>都会被自动转成HTML实体，这样很容易在代码区段插入HTML。

总结

目前，已经掌握了Markdown的基础用法，相信编写一般的文档不是问题。接下来继续javascript的学习。唉，好烦，辞职信发给老板了，老板求着我不要走，为何如此，为何，作为一个硬件工程师，追求自己的职场道路，技术巅峰，离职是明智选择。可是毕竟干了两年，将公司的硬件平台搭起来了。老板说是见成果的时刻，我为何感觉如此空虚，每次上班都堵得慌？明天再说吧。