Markdown入门

| 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

参考形式:

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

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

语法示例:

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

效果图:

alt 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

Comments