1. Markdown 极简教程

Markdown 的目标是实现「易读易写」。也是兼容 HTML 的, 是一种适用于网络的书写语言。

Markdown is a way to style text on the web. You control the display of the document; formating words as bold or italic, adding images, and creating lists are just a few of the things we can do with Markdown. Mostly, Markdown is just regular text with a few non-alphabetic characters thrown in, like # or *.

文本 (Text)

源码:
It's very easy to make some words **bold** and other words *italic* with Markdown. You can even [link to Google!](http://google.com)

效果:
It’s very easy to make some words bold and other words italic with Markdown. You can even link to Google!

文字的强调效果(EMPHASIS)
源码:

• *倾斜*
• **加粗**
• ~~中划线效果~~
• _You **can** combine them_

效果:

• 倾斜
• 加粗
• 中划线效果
• You can combine them

标题 (Headers)

支持六级标题, h1 级标题最大，h6 级标题最小
源码:

# This is an <h1> tag
## This is an <h2> tag
###### This is an <h6> tag

效果:

引用(BLOCKQUOTES)

源码:

As Kanye West said:

> We're living the future so
> the present is our past.

效果:

As Kanye West said:

We’re living the future so
the present is our past.

列表(LISTS)

无序列表(Unordered)

* Item 1
* Item 2
  * Item 2a
  * Item 2b

效果:

• Item 1
• Item 2
  • Item 2a
  • Item 2b

有序列表(Ordered)

1. 这是一个有序列表1
2. 这是一个有序列表2

效果:

1. 这是一个有序列表1
2. 这是一个有序列表2

• 列表可以嵌套，使用时在嵌套列表前加两个空格
• 使用* - +中的任一个符号就可创建无序列表，也可以进一步使用+ -来有层次组织有序和无序列表

链接(LINKS)

Markdown 支持两种形式的链接语法： 行内 和 参考 两种形式，两种都是使用小括号来把文字转成链接。

## 行内式

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

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

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

## 参考式

这种链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容。

下面是一个参考式链接的示例

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

  [1]: http://google.com/        'Google'
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

也可直接只用链接名称，甚至省略方括号。

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN].

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

• 参考式的链接重点不在于它比较好写，而是它比较好读。
• 使用 Markdown 的参考式链接，可以让文件更像是浏览器最后产生的结果，让你可以把一些标记相关的元数据移到段落文字之外，你就可以增加链接而不让文章的阅读感觉被打断。

图像(IMAGES)

像构造链接一样，只需要在前面加！

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)

# 示例
![图1](http://upload-images.jianshu.io/upload_images/95646-5bfd0cecf587c766.png)

内联代码 (Inline code)

I think you should use an `<addr>` element here instead.

I think you should use an <addr> element here instead.

支持 html

<u>支持下滑线</u>

支持下滑线了

反斜线转义

Markdown allows you to use backslash escapes to generate literal characters which
would otherwise have special meaning in Markdown’s formating syntax.

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

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

markdown 拓展

代码段

• 使用反单引号(位于键盘中数字键“1”的左边)包裹一行代码。
• 使用` ````包裹一块代码。
• 或者简单的每行前加四个空格

you can wrap your code with ```to create a code block without the leading spaces. Add an optional language identifier and your code will get syntax highlighting.

// javascript语法高亮
function test() {
    console.log("look ma’, no spaces");
}

// java语法高亮
protected final void sayHello() {
    if (true) System.out.println("Hello friend.");
}

表格(TABLES)

You can create tables by assembling a list of words and dividing them
with hyphens - (for the first row), and then separating each column
with a pipe | :

First Header | Second Header
------------ | -------------
Content cell 1 | Content cell 2
Content column 1 | Content column 2

对齐方式
我们可以设置表格的对齐方式：

• -: 设置内容和标题栏居右对齐。
• :- 设置内容和标题栏居左对齐。
• :-: 设置内容和标题栏居中对齐。

分隔符

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。

再谈谈特殊字符转换

Markdown 让你可以自然地书写字符，需要转换的会由它自行处理。如果你使用的 & 字符是 HTML 字符实体的一部分，它会保留原状，否则它会被转换成 &。

char glyph | HTML tag
"          |    "
&          |    &
<          |    <
>          |    >

一些拓展语法

各 markdown 软件对其进行了一些拓展, 有的支持脚注、有的会定义 checkbox 等操作、使用 toc 展示目录等操作。

关于现代网页分段的思考

• 目前中文段落开头空格 2 个字的需求，以前用转义字符, 现在网站流行不空格, 段落划分建议通过空行实现。
• 段落以自然 回车 作为标记。

参考

1. Markdown 语法说明(简体中文版)
2. Mastering Markdown · GitHub Guides