Markdown基本用法

标题

样式的标题每行开头使用 1-6 井号, 对应 1-6 级标题. 例如:

• # H1
• ## H2
• ### H3
• #### H4
• ##### H5
• ###### H6

块引用

Markdown 使用 email 样式的 `>` 字符作为块引用. 如果你熟悉 email 消息中的引用段落, 那么你同样可以在 Markdown 中创建块引用. 最好对引用文本采取强制换行并在每一行行首放一个 `>` :

    > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
    consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
    Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

    > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
    id sem consectetuer libero luctus adipiscing.

块引用可以嵌套 (例如, 块引用中包含块引用) , 只需添加额外层级的 `>` 即可:

    > This is the first level of quoting.
    >
    > > This is nested blockquote.
    >
    > Back to the first level.

列表

Markdown 支持有序列表和无序列表.

无序列表使用星号, 加号, 和连字符 -- 这些符号是可互换的 -- 最为列表标记:

    *   Red
    *   Green
    *   Blue

有序列表使用数字加句号:

    1.  Bird
    2.  McHale
    3.  Parish

代码块

在 Markdown 中插入代码块, 只需要将每一行都缩进 4 个空格或者 1 个水平制表符. 例如, 下面的输入:

    This is a normal paragraph:

        This is a code block.

水平线

如果一行中只有三个以上的连字符, 星号, 或者下划线则会在该位置生成一个 `<hr/>` 标签. 星号和连字符之间的空格也是允许的. 下面的例子都会生成一条水平线:

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

链接

Markdown 支持两种链接形式: *内联* 和 *引用*.

这两种形式下链接文本的定界符都是 [中括号].

要创建内联链接, 只需在链接文本的右括号后面紧接一对圆括号. 圆括号里面放所需的 URL 链接, 还可以放一个 可选 的链接标题, 标题要用引号包围. 例如:

    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.

接下来, 在文档中的任意位置, 你可以像下面那样定义链接标签, 需要单独占一行:

    [id]: http://example.com/  "Optional Title Here"

也就是:

• - 方括号中包含链接标识符 (可以用三个以上的空白符来添加缩进);
• - 跟着是冒号;
• - 跟着是一个以上的空白符和水平制表符;
• - 跟着是链接的 URL;
• - 跟着是可选的标题属性, 可以用单引号, 双引号, 或者圆括号包围.

强调

Markdown 将星号 (`*`) 和下划线 (`_`) 作为强调标记. 用 `*` 或者 `_` 包裹的文本将会用 HTML `<em>` 标签包裹; 双 `*` 或者 `_` 将会用 HTML `<strong>` 标签包裹. 例如, 下面的输入:

    *single asterisks*

    _single underscores_

    **double asterisks**

    __double underscores__

代码

要输出一个代码片段, 需要使用重音符号 ( ` ). 不同于预格式的代码块, 代码片段只是在普通段落中标识出代码. 例如:

    Use the `printf()` function.

要在代码片段中包含字面量的重音符号, 可以使用多个重音符号作为起始和结束标记:

   ``There is a literal backtick (`) here.``

在代码片段中, 英镑符号和尖括号会被转换成相应的字符实体, 这使得包含 HTML 标签很容易. Markdown 会将下面的代码:

    Please don't use any `<blink>` tags.

图片

通常, 要用 "原生" 的语法在纯文本格式中插入图片是很困难的.

Markdown 使用了类似链接的语法来插入图片, 包含两种形式: **内联** 和 **引用**.

内联图片语法如下:

    ![Alt text](头像1200.jpg)

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

也就是:

• - 一个感叹号: `!`;
• - 紧跟着一对方括号, 包含了图片的 `alt` 属性;
• - 紧跟着一对圆括号, 包含了图片的 URL 或者路径, 以及一个可选的用单引号或双引号包裹的 `title` 属性.

引用图片语法如下:

    ![Alt text][id]

"id" 是图片引用的名称. 图片引用使用链接定义的相同语法:

   [id]: 头像1200.jpg  "Optional title attribute"

Markdown 没有语法指定图片尺寸; 如果需要指定图片尺寸, 可以使用 HTML `<img>` 标签.

反斜杠转义

Markdown 中可以使用反斜杠转义 Markdown 语法符号为字面量. 例如, 如果你想用星号包围一个单词 (而不是 HTML 的 `<em>` 标签), 你可以在星号前面加反斜杠, 就像这样:

\*literal asterisks\*

Markdown 为下面字符提供反斜杠转义:

    \   backslash
    `   backtick
    *   asterisk
    _   underscore
    {}  curly braces
    []  square brackets
    ()  parentheses
    #   hash mark
    +   plus sign
    -   minus sign (hyphen)
    .   dot
    !   exclamation mark