Markdown 学习

# 特殊字符在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体.Markdown会将特殊字符自动转换。&copy;AT&T4 < 5***# 标题第一种标题设置方式Setext，在当前行下一行添加==，或者--，对应一级二级标题：this is an H1====这是H2---第二种设置方式atx：在行首加#几级标题加几个#（1-6级）# 你好## hello###### 我是六级标题***# 引用>这是引用部分>引用内容>>二级引用>>>我是三级标题>>我是一级引用>在这里仍可以使用其他markdown语法,包括标题、列表、代码区块等：>  >       #include <stdio.h>>       //这是引用区块代码区域*一定要注意缩进*无序列表使用星号、加号或是减号作为列表标记* 苹果* 香蕉* 梨子有序列表则使用数字接着一个英文句点：1. 我是第一个2. 我是第二个3. 我是第三个列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符；列表项目内有引用的情况 > 需要缩进：*   A list item with a blockquote:    > This is a blockquote    > inside a list item.如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符：*   一列表项包含一个列表区块：        #include<stdio.h>        int main(){            printf("Hello,World!\n");            return 0;        }***# 代码区块在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠:1986. What a beautiful day!1986\.What a beautiful day!在 Markdown中建立代码区块只要简单地缩进 4 个空格或是 1 个制表符就可以.这是一个普通段落：    #include<stdio.h>        int main(){            printf("你现在也算了解了基本语法!\n");            return 0;        }一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。***你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：____减号的分割线是将上一行变为二级标题--------# 链接Markdown有：行内式和参考式两种形式的链接语法，但两种的链接文字都是用[方括号]来标记的。建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：This is [an example](http://example.com/ "Title") inline link.[This link](http://example.net/) has no title attribute.如果是链接到当前主机资源可以用相对路径：See my [About](/about/) page for details.参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：This is [an example][id] reference-style link.你也可以选择性地在两个方括号中间加上一个空格：This is [an example] [id] reference-style link.接着，在文件的任意处，你可以把这个标记的链接内容定义出来：[id]: http://example.com/  "Optional Title Here"链接内容定义的形式为：方括号（前面可以选择性地加上至多三个空格来缩进），* 里面输入链接文字* 接着一个冒号* 接着一个以上的空格或制表符* 接着链接的网址* 选择性地接着 title内容，可以用单引号、双引号或是括弧包着下面这三种链接的定义都是相同：    [foo]: http://example.com/  "Optional Title Here"    [foo]: http://example.com/  'Optional Title Here'    [foo]: http://example.com/  (Optional Title Here)隐式链接标记可以省略指定链接标记，此时链接标记等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号。[Google][]然后定义链接内容：[Google]: http://google.com/链接的定义可以放在文件中的任何一个地方。***# 强调Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 <em> 标签包围，用两个 * 或 _ 包起来的话，则会被转成 <strong>，例：*single asterisks*_single underscores_**double asterisks**__double underscores____如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号,而且你需要做到开始标签和结束标签匹配。__***# 代码标记一小段行内代码，你可以用反引号把它包起来（`），如：Use the `printf()` function.如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：``There is a literal backtick (`) here.``代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号:\A single backtick in a code span: `` ` ``A backtick-delimited string in a code span: `` `foo` ``# 图片图片的语法和链接很相似，有两种：行内式和参考式\**行内式**的语法为：* 一个惊叹号 !* 接着一个方括号，里面放上图片的替代文字* 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。如同下面：```![Alt text](/path/to/img.jpg)![Alt text](/path/to/img.jpg "Optional title")```参考式语法大致如下：```![Alt text][id][id]:url/to/image "Optional title attribute"```目前markdown还不支持指定图片的高和宽，如果需要可尝试<img>标签# 自动链接 Markdown会自动把尖括号包起来的内容转成链接，常用来处理邮箱和网址。 <http://example.com>\ <[e-mail]>  # 反斜杠 Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），你可以在星号的前面加上反斜杠：\ \*literal asterisks\* Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：```\   反斜线`   反引号*   星号_   底线{}  花括号[]  方括号()  括弧#   井字号+   加号-   减号.   英文句点!   惊叹号```

效果如下：

特殊字符

在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体.Markdown会将特殊字符自动转换。

©

AT&T

4 < 5

---

标题

第一种标题设置方式Setext，在当前行下一行添加==，或者--，对应一级二级标题：

this is an H1

这是H2

第二种设置方式atx：在行首加#几级标题加几个#（1-6级）

你好

hello

我是六级标题

---

引用

这是引用部分

引用内容

二级引用

我是三级标题

我是一级引用 在这里仍可以使用其他markdown语法,包括标题、列表、代码区块等：

#include <stdio.h>  //这是引用区块代码区域

一定要注意缩进

无序列表使用星号、加号或是减号作为列表标记

• 苹果
• 香蕉
• 梨子

有序列表则使用数字接着一个英文句点：

1. 我是第一个
2. 我是第二个
3. 我是第三个

列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符；

列表项目内有引用的情况 > 需要缩进：

• A list item with a blockquote:

  This is a blockquote inside a list item.

如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符：

• 一列表项包含一个列表区块：

  #include<stdio.h>int main(){    printf("Hello,World!\n");    return 0;}

---

代码区块

在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠:

1986. What a beautiful day!

1986.What a beautiful day!

在 Markdown中建立代码区块只要简单地缩进 4 个空格或是 1 个制表符就可以. 这是一个普通段落：

#include<stdio.h>    int main(){        printf("你现在也算了解了基本语法!\n");        return 0;    }

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

---

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

---

减号的分割线是将上一行变为二级标题

链接

Markdown有：行内式和参考式两种形式的链接语法，但两种的链接文字都是用[方括号]来标记的。

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

This is an example inline link.

This link has no title attribute.

如果是链接到当前主机资源可以用相对路径：See my About page for details.

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

This is an example reference-style link.

你也可以选择性地在两个方括号中间加上一个空格：

This is an example reference-style link.

接着，在文件的任意处，你可以把这个标记的链接内容定义出来：

链接内容定义的形式为：

方括号（前面可以选择性地加上至多三个空格来缩进），* 里面输入链接文字

• 接着一个冒号
• 接着一个以上的空格或制表符
• 接着链接的网址
• 选择性地接着 title内容，可以用单引号、双引号或是括弧包着

下面这三种链接的定义都是相同：

[foo]: http://example.com/  "Optional Title Here"[foo]: http://example.com/  'Optional Title Here'[foo]: http://example.com/  (Optional Title Here)

隐式链接标记可以省略指定链接标记，此时链接标记等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号。

Google 然后定义链接内容：

链接的定义可以放在文件中的任何一个地方。

---

强调

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

single asterisks single underscores double asterisks double underscores

如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号,而且你需要做到开始标签和结束标签匹配。

---

代码

标记一小段行内代码，你可以用反引号把它包起来（`），如：

Use the printf() function.

如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段： There is a literal backtick (`) here.

代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号:
A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片

图片的语法和链接很相似，有两种：行内式和参考式
行内式的语法为：

• 一个惊叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。 如同下面：

![Alt text](/path/to/img.jpg)![Alt text](/path/to/img.jpg "Optional title")

参考式语法大致如下：

![Alt text][id][id]:url/to/image "Optional title attribute"

目前markdown还不支持指定图片的高和宽，如果需要可尝试<img>标签

自动链接

Markdown会自动把尖括号包起来的内容转成链接，常用来处理邮箱和网址。 http://example.com
[e-mail]

反斜杠

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

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

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

参考文献：

Markdown 语法说明 (简体中文版)

怎样使用Markdown