Skip to content

Simplelified Chinese Edition Guide of Markdown Syntax

Notifications You must be signed in to change notification settings

Yonlin/Markdown-Simple-Guide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 

Repository files navigation

Markdown 简明语法教程

说明:

  • 本教程基于Markdown语言编写。
  • 本教程定位为基础教程,更加详细的用法可参考其他资料。
  • 例子中方框内的代码为Markdown的语法。
  • 推荐使用Haroopad(Win)和Mou(OS X)编辑器,部分编辑器中文效果欠佳,可通过自定义CSS字体解决。

基本

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

字体

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

    例如:

    *斜体*
    _斜体_
    

    效果:

    斜体

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

    例如:

    **强调**
    __强调__
    

    效果:

    强调

换行

  • 单一段落用空白行。
  • 换行是连续2个空格。

标题

  • 生成<h1>-<h6>,是通过在文字前面加上1-6个#符号来实现。

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

    例如:

    ## 这是标题
    ## 这是标题 ##
    

    效果:

    这是标题

列表

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

    例如:

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

    效果:

    • 第一行
    • 第二行
    • 第三行
    1. 第一行
    2. 第二行
    3. 第三行

引用

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

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

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

    例如:

    > 引用
    > > 引用中的引用
    

    效果(本例本身处于引用效果中):

    引用

    引用中的引用

代码区块

  • `是表示inline代码,tab是用来标记代码段,分别对应HTML的<code><pre>标签。

    例如:

    `sort()` 函数按升序对给定数组的值排序。
    
        <?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支持两种形式的链接语法:行内式和参考式两种形式。

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

    [Melo618](http://melo618.com "Melo618的博客")
    

    效果:

    Melo618

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

    [Melo618][blog]
    [blog]: http://melo618.com "Melo618的博客"
    

    效果:

    Melo618

图片

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

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

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

    ![微信](http://melo618.com/resources/images/my-weixin.png "微信")
    

    效果:

    微信

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

    ![微信][QR]
    [QR]: http://melo618.com/resources/images/my-weixin.png "微信"
    

    效果:

    微信

分隔线

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

    例如:

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

    效果:



表格

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

    例如:

    | Title   | Description                       |
    | :------ | :-------------------------------: |
    | Version | 0.0.1                             |
    | Editor  | [EDITOR](mailto:EDITOR@Email.com) |
    

    效果:

    Title Description
    Version 0.0.1
    Editor EDITOR

特殊符号

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

推荐阅读

About

Simplelified Chinese Edition Guide of Markdown Syntax

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages