尝试加载完整版本的论坛时出错，请清空浏览器缓存后再试。

Markdown 简明语法教程

FGHRSH


说明

  • 本教程基于 Markdown 语言编写，项目地址位于 Simple-Markdown-Guide。
  • 本教程定位为基础教程，更加详细的用法可参考其他资料。

基本

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

为什么要使用它？

  • 它 易读(看起来舒服)、易写(语法简单)、易更改(纯文本)。处处体现着极简主义的影子。
  • 兼容 HTML ，可以转换为 HTML 格式发布。
  • 跨平台使用。
  • 越来越多的网站支持 Markdown 。
  • 因为 在这个社区发帖要用。（别打我

字体

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

    *斜体*
_斜体_

    效果：
    斜体

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

    **强调**
__强调__

    效果：
    强调


换行

  • 单一段落用空白行。
  • 或是选择在行末加两个空格。

标题

  • 生成 <h1> - <h6> 标签，是通过在文字前面加上同等个数 # 符号来实现。
  • 出于美观，也可以使用 对称的 闭合式标题符号。
    例如： 
    ### 这是标题
### 这是标题 ###
    效果：

    这是标题


列表

  • *，-，+ 这三个符号效果都一样，这3个符号被称为 Markdown 列表符号。而有序列表则使用数字接着一个英文句点（数字大小并不会影响输出序列）。
    例如： 
     - 第一行
 - 第二行
 - 第三行
 6 第四行
 5 第五行
 4 第六行
    效果：
    无序列表：
    • 第一行
    • 第二行
    • 第三行

有序列表：
6. 第四行
5. 第五行
4. 第六行


引用

  • > 符号表示引用，可简写于第一行，也可以每一行都添加。
  • 区块的引用可以嵌套，只需要在层次数上加上同等数量的 > 符号。
  • 引用内可以使用其他 Markdown 语法，包括 标题、列表、代码区块 等。
    例如： 
    >    引用
>    >    引用中的引用
    效果：

引用

引用中的引用


链接

  • Markdown 支持两种形式的链接语法：行内式 和 参考式 两种形式。
    行内式链接，是在方括号后面接圆括号即可。
    例如： 
     [艾泽社区](https://mc.aizecraft.cn)
    效果：
    艾泽社区

图片

  • Markdown 使用一种和链接很相似的语法来标记图片，只是多了一个 ! 在最前面。
  • 目前为止，Markdown 还没有办法指定图片的宽高。
    行内式链接，是在方括号后面接圆括号即可。
    例如： 
    ![Tamako's Sticker 092](https://fp1.fghrsh.net/2017/12/08/a4d13d27f3db65a92380ee0dedefedb3.png)
    效果：
    Tamako's Sticker 092

代码区块

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

    例如：

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

    围栏式代码块

    ```php
    <?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);
?>

特殊符号

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

License

liwanglin12

前来兹磁（