转自


说明:

  • 本教程基于 Markdown 语言编写,项目地址位于 Simple-Markdown-Guide
  • 本教程定位为基础教程,更加详细的用法可参考其他资料。
  • 本教程中代码块内的代码为 Markdown 的语法。
  • 本教程中部分语法使用的是 GitHub Flavored Markdown,GFM 语法与标准语法在不同环境中存在解析差异,本教程在使用时会加以说明。
  • 推荐使用 Haroopad (Win)、MarkdownPad (Win) 和 Mou (OS X) 编辑器,部分编辑器中文效果欠佳,可通过自定义 CSS 字体解决。

基本

  • Markdown 是一种用来写作的轻量级标记语言。
  • 用标记语法,来代替常见的排版格式。
  • 兼容 HTML 代码。
  • 特殊字符自动转换,例如 <&

字体

  • 使用星号 * 和底号_表示 <em> 标签。

    例如:

    1
    2
    *斜体*
    _斜体_

    效果:

    斜体

  • 使用双星号 ** 和双底号__表示 <strong> 标签。

    例如:

    1
    2
    **强调**
    __强调__

    效果:

    强调

换行

  • 单一段落用空白行。

标题

  • 生成 <h1>-<h6> 标签,是通过在文字前面加上同等个数#符号来实现。

  • 出于美观,也可以使用对称的闭合式标题符号。

    例如:

    1
    2
    ### 这是标题
    ### 这是标题 ###

    效果:

    这是标题

列表

  • *-+ 这三个符号效果都一样,这 3 个符号被称为 Markdown 列表符号。而有序列表则使用数字接着一个英文句点(数字大小并不会影响输出序列)。

    例如:

    1
    2
    3
    4
    5
    6
    * 第一行
    * 第二行
    * 第三行
    6. 第四行
    5. 第五行
    4. 第六行

    效果:

    • 第一行
    • 第二行
    • 第三行
    1. 第四行
    2. 第五行
    3. 第六行

引用

  • > 符号表示引用,可简写于第一行,也可以每一行都添加。

  • 区块的引用可以嵌套,只需要在层次数上加上同等数量的 > 符号。

  • 引用内可以使用其他 Markdown 语法,包括标题、列表、代码区块等。

    例如:

    1
    2
    >    引用
    > > 引用中的引用

    效果:

    引用

    引用中的引用

代码区块

  • ` 是表示 inline 代码,4 个(空格)来表示缩进式代码段,分别对应 HTML 的 <code><pre> 标签。也可以使用 ``` 来表达围栏式代码块(GFM 语法,部分编辑器不支持),并指定他的语言类型,实现语法高亮。围栏式代码块可以大量减少缩进的使用,大规模的代码块使用非常方便。

    例如:

    1
    `sort()` 函数按升序对给定数组的值排序。

    普通的缩进式代码块。

    1
    2
    3
    4
    5
    <?php
    $my_array = array('a' => 'Dog', 'b' => 'Cat');
    sort($my_array);
    print_r($my_array);
    ?>

    带语法高亮的围栏式代码块(GFM 语法,部分编辑器不支持)。

    1
    2
    3
    4
    5
    <?php
    $my_array = array('a' => 'Dog', 'b' => 'Cat');
    sort($my_array);
    print_r($my_array);
    ?>

    效果:

    sort() 函数按升序对给定数组的值排序。

    普通的缩进式代码块。

    <?php
        $my_array = array('a' => 'Dog', 'b' => 'Cat');
        sort($my_array);
        print_r($my_array);
    ?>
    

    带语法高亮的围栏式代码块(GFM 语法,部分编辑器不支持)。

    1
    2
    3
    4
    5
    <?php
    $my_array = array('a' => 'Dog', 'b' => 'Cat');
    sort($my_array);
    print_r($my_array);
    ?>

链接

  • Markdown 支持两种形式的链接语法:行内式和参考式两种形式。

    行内式链接,是在方括号后面接圆括号即可。
    例如:

    1
    [Google](https://www.google.com "Google")

    效果:

    Google

    参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记。
    例如:

    1
    2
    3
    [Google][GOOGL]

    [GOOGL]: https://www.google.com "Google"

    效果:

    Google

图片

  • Markdown 使用一种和链接很相似的语法来标记图片,只是多了一个 ! 在最前面,同样也允许两种样式:行内式和参考式。

  • 目前为止,Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。

    行内式链接,是在方括号后面接圆括号即可。
    例如:

    1
    ![Wikipedia](https://www.wikipedia.org/portal/wikipedia.org/assets/img/Wikipedia-logo-v2.png "Wikipedia")

    效果:

    Wikipedia

分隔线

  • 使用三个以上的 *- 来建立一个分隔线,行内不能有其他字符。

    例如:

    1
    2
    3
    4
    * * *
    ***
    - - -
    ---

    效果:

    上文


    下文

表格

  • Markdown 使用 |- 来绘制表格,: 可控制左对齐、右对齐及居中。

    例如:

    1
    2
    3
    4
    | Title   | Description                        |
    | :------ | :--------------------------------: |
    | Version | 0.0.1 |
    | Editor | [Melo618](mailto:[email protected]) |

    效果:

    TitleDescription
    Version0.0.1
    EditorMelo618

特殊符号

  • Markdown 利用 \ 字符来转义一些在语法中有特殊意义的符号。

推荐阅读

License

Copyright © 2014-2018, Melo Chan. MIT License.


网站地图 | 状态监测 | 图片加密&解密 | File Server | 博友圈 | 博客说
Copyright 2022-2025 | Powered by Hexo 7.3.0 & Stellar 1.29.1
总访问量次 |