Markdown入门

FEB 27TH, 2013 | COMMENTS

前言

github真的很强大，原来以为只是一个代码托管及项目版本控制的网站，没想到还可以搭建blog及wiki。按照网上的教程，磕磕碰碰的终于搭建好了blog。借着建这个blog的机会，学习下Markdown和git。首先，学习下Markdown标记语言，因为github上blog要求用标记语言写，不学这个blog都写不起来。

本文就是我参考Wow!Ubuntu和维基百科上教程及自己的实践写的（是用Markdown写的哦），只涉及到Markdown入门语法，学完后基本上能写blog。可以使用在线markdown编辑器学习，这样起到“所写即所得”作用，加深印象。这里介绍一个在线Markdown编译器，可以转换成html及实时预览。好了，开始我们的Markdown学习之旅。。

1.标题

一篇文章首先是标题。Markdown支持两种标题语法，Settext和atx形式。

• Settext形式：利用底线形式，用 = （最高级标题） 和 - （第二级标题）作为底线形式标题的标记。

• atx形式：在行首插入 1 到 6 个 #，对应标题 1 到 6 级（从大到小顺序）。

atx比Settext提供更多规格的标题形式，atx中 # 和 ## 分别对应Settext中 = 和 - 。

语法示例：

Fisrt Level Header==================Second Level Header-------------------# Header 1 (equal `=`)## Header 2 (equal `-`)

2.引用

文章中经常引用别人的话，为区别开来可以用引用标记特别注明。Markdown中使用email形式的 ‘>‘（右尖括号号）。可以在引用段落前加一个，也可以在段落每行前面加一个。如果区块引用由几段组成，引用段落之间需要加一个 >区分引用不同段落（这是引用标记和段落标记的组合）。

语法示例：

> This is a blockquote.>> This is the second paragraph in the blockquote.>> ## This is an H2 in a blockquote

3.段落

一篇文章由N个段落组成。一个段落由一个或多个连续的行构成，Markdown通过一个以上的空行区别不同的段落。只要看起来像空行，不管是由空格符还是tab组成的，一律视为空行。

多个空格会被看成一个空格。一般段落首行没有缩进，如果需要首行缩进的话可用  (全方大空白)或   （半方大空格）。

语法示例：

&emsp 这是段落1这是段落2

4.强调

Markdown使用星号 * 和底线 _ 标记强调区段。在强调部分前加上标记，在强调部分结束后加上标记限制强调范围。注意星号强调标志与强调内容之间不能有空格存在，不然变成无序列表了。

语法示例：

*强调部分变为斜体*  或 _强调部分变为斜体_**加重强调部分变为粗体**  或 __加重强调变为粗体__***特别强调部分变为粗斜体*** 或 ___特别强调部分变为粗斜体___

5.列表

列表分为无序列表和有序列表两种。 无序列表使用星号、加号、减号三种中任意一种作为无序列表的项目标记。三种符号可混用，但不建议这样做。注意列表标记和列表项目之间必须至少一个空格。

语法示例：

* 无序列表中一项* 子项，以一个tab或者4个空格缩进* 无序列表中另一项+ 无序列表另一项- 无序列表另一项

有序列表使用数字接一个英文句点作为项目标记。注意数字和句点间不能有空格，句点和项目内容之间至少有一个空格。

语法示例：

1. 有序列表一项2. 有序列表另一项

6.链接

Markdown支持两种形式链接语法。

行内插入链接：

[链接文字](链接地址)示例： [github](http://www.github.com)

参考形式链接：类似于文献中最后列出的参考文献。

内容行内插入：

[链接文字][链接引用标签]

在段落后面或文档结尾放上一下内容，生成一个链接：

[链接引用标签]: 链接地址 "链接标题"

注意其中的冒号和引号都是英文符号。建议链接引用标签用数字表示，可以统计数量。 我在github上建立了blog。 1: http://qingu.github.com “github”

7.图片

图片引用类似于链接引用。图片可以是网络图片，也可以是本地图片，本地图片建议放在source/images目录中，按年月建立两层目录放置便于归档。本地图片的url类似为/images/year/month/img.png。

行内形式（title可选）： 

参考形式：

行内引用 ![alt text][id]

段落结束或文档结尾生成一个图片引用 [id]: /path/to/img.jpg “title”

语法示例：

![alt MyEmail](/images/myemail.png "MyEmail")

效果图：

8.代码

两种选择，一种是把代码用反引号 ` 括起来。另一种是以制表符或至少 4 个空格缩进的行（常用于代码段）。本文中白底黑字就是用第一种方法，墨绿色底的代码块用的是第二种方法。

9.水平分割线

要生成水平分割线，可以在单独一行里输入3个或以上的短横线（减号）、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条水平分割线。

* * **********- - ----------------------

参考资料

1 http://wowubuntu.com/markdown/basic.html

2 http://http://zh.wikipedia.org/wiki/Markdown

3 http://www.ostools.net/markdown

Posted by Qingu Jiang Feb 27th, 2013  markdown

转自：http://metman.info/blog/2013/02/27/markdownru-men/