Markdown 易学易用 使用笔记

What，Markdown是什么

Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。Markdown 是一个 Web 上使用的文本到HTML的转换工具，可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。

Why，Markdown有什么好处

• 专注内容
  让你专注于文字而不是排版。
• 易学易用
  Markdown 的标记语法有极好的可读性，几分钟就可以简单上手。
• 兼容性强
  纯文本，可以用所有文本编辑器打开。
• 格式转换方便
  Markdown 的文本你可以轻松转换为 html、电子书等。
• 功能强大
  可以绘制表格、UML图等

How，Markdown怎么用

段落

一个段落是由一个以上的连续的文本行组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

一级标题
=========

二级标题
-------------

任何数量的 = 和 - 都可以有效果。

类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

#    一号标题

###    三号标题

#####    五号标题

你可以选择性地「闭合」类 atx 样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上 #，而行尾的 # 数量也不用和开头一样（行首的井字符数量决定标题的阶数）：

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

强调

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

*斜体*                //ctrl + i

_斜体_              

**粗体**             //ctrl + b

__粗体__

~~添加删除线~~

引用

引用只需要在被引用的内容段落开头加上右尖括号('>')即可。你可以选择只在开头加一个。也可以在每行前面都加一个，效果是一样的。

> 这一整段的内容都会作为一个HTML的引用元素。
引用元素是会自动优化排版的（reflowable，可回流）。
你可以任意地将引用的内容包含进来，然后所有这些都会
被解析成为单独一个引用元素。

引用可以嵌套。如果要在一个引用里插入一个引用，可以用两个('>')开头。依此类推，根据嵌套层次加相应数量的符号。

>这是一个引用。这是第一行
这是第二行。

>>这是一个嵌套的引用。这是第一行。
这是第二行
>
>外层引用的第三行。前面需要一个视觉上的空行表示内层嵌套的结束，空行前面的('>')可以有可以没有。

列表

Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记(ctrl + U)：

* Hello
* Hi
* Are you OK?

等同于

+ Hello
+ Hi
+ Are you OK?

也等同于

- Hello
- Hi
- Are you OK?

代码

如果要标记一小段行内代码，你可以用反引号把它包起来（`），例如：
this is a inline code .
如果要建立一个已经格式化好的代码区块，只要每行都缩进 4 个空格或是一个 tab 就可以了，而 &、< 和 > 也一样会自动转成 HTML 实体。

如果要标记一块代码，你可以用多个反引号来开启和结束代码区段：

```
There is a block code (\`) here.
block code
```

There is a block code here.
block code

链接

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

要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is an example inline link.
This link has no title attribute.

图片

![Alt text](/static/img/common/logo.png?t=1)

![Alt text](/static/img/common/logo.png?t=1 "Optional title")

表格

|姓名|性别|年龄|
|--|---|---|
|da|sd|da|

姓名	性别	年龄
da	sd	da

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），你可以在星号的前面加上反斜杠：

 \*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

分割线

分割线的语法只需要另起一行，连续输入三个星号 *** 即可。

参考

http://www.markdown.cn/