MarkDown语法练习笔记

MarkDown使用规则

1. 标题
   Markdown 支持两种标题的语法，类 Setext 和类 atx 形式

   • Setext 形式:用底线的形式

     Selext形式采用：

     1、最高阶标题（=）
     2、第二阶标题（-）

     实例

     这是最高阶标题  
     ============
     
     第二阶标题
     ---
     

     效果

     ---

     这是最高阶标题

     第二阶标题

     ---

   • 类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶
     

     实例

     # 这是 H1
     
     ## 这是 H2 ##
     
     ###### 这是 H6
     

     效果

     ---

     这是 H1

     这是 H2

     这是 H6

     ---

     注意：# 号可以只写前面的一部分，当然也可以闭合起来

2. 段落与换行

   • 段落
     

     MarkDown的段落是由一个到多个连续的文本行组成的，如何定义段落？
     答案就是：空行，对，每个段落之间使用空行，MarkDown在渲染的时候就会知道这是一段

   • 换行

     两个空格，MarkDown在渲染的时候对于一行文本末尾包含两个或两个以上的空格时，将进行换行处理

   • 实例

     这里是第一段文本，请仔细观察这段和下面那一段中的换行在渲染后的不同效果。

     这是第二段的第一句话：这是一段测试文本，这是一段测试文本，这是一段测试文本，这是一段测试文本。
     第二句文本：注意在第一句文本最后的两个空格 ，这是一段测试文本，这是一段测试文本，这是一段测试文本，

3. 区块引用

   • MarkDown区块采用 ">" 就像这样：
     

     > 这是区块引用实例写法
     > 这种写法是在每行前面都添加引用符 >
     > 其实我们也可以在每一段文本前面添加一个 > 就可以了，但是这么做请注意段落之间的空行不能超过两个，否则可能不会按照你的想法进行渲染
     
     > 这是段首，文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本
       文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本
     
     > 这是一个新的段落，内容内容内容内容内容内容内容内容内容内容内容内容内容内容
      内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容
     

     渲染后的效果：

     这是区块引用实例写法
     这种写法是在每行前面都添加引用符 >
     其实我们也可以在每一段文本前面添加一个 > 就可以了，但是这么做请注意段落之间的空行不能超过两个，否则可能不会按照你的想法进行渲染

     这是段首，文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本
     文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本

     这是一个新的段落，内容内容内容内容内容内容内容内容内容内容内容内容内容内容
     内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容

     注意：在引用能可以正常的使用其他的Markdown语法

     ## 这是一个标题。
     
     1.   这是第一行列表项。
     2.   这是第二行列表项。
     

4. 列表

   • 有序列表:
     星号、加号或是减号作为列表标记

     *   Red
     *   Green
     *   Blue
     等同于
     +   Red
     +   Green
     +   Blue
     等同于
     -   Red
     -   Green
     -   Blue
     

     渲染后：

     • Red
     • Green
     • Blue
       等同于

     • Red
     • Green
     • Blue
       等同于

     • Red
     • Green
     • Blue

   • 无序列表
     使用数字接着一个英文句点

     1.  Bird
     2.  McHale
     3.  Parish
     

     渲染后

     1. Bird
     2. McHale
     3. Parish

     无序列表标记使用的数字并不影响渲染后的输出

     1.  Bird
     1.  McHale
     1.  Parish
     

     渲染后

     1. Bird
     2. McHale
     3. Parish

     6.  Bird
     3.  McHale
     12.  Parish
     

     渲染后

     1. Bird
     2. McHale
     3. Parish

5. 代码块

   在 Markdown 中建立代码区块很简单

   1. 只要简单地缩进 4 个空格或是 1 个制表符就可以
   2. 使用 ` 这个符号，进行行内代码块的标注,就像这样
      

      这里是一段文本，文本中间开始有一些代码需要显示就可以这样: `int i = 0;`
      

      渲染后效果
      这里是一段文本，文本中间开始有一些代码需要显示就可以这样: int i = 0;

   3. 那么代码块怎么使用 ` 呢？ 当我们需要对一段代码块完成Markdown的效果时，可以在代码块的前后各添加三个 ` 符号，一共是六个。就像这样
      

      ` ` `
      int i = 0;
      i = 1;
      for (int i = 0; i < 100; i++)
      {
         printf("hello markdown!\n");
      }
      ` ` `
      

      渲染后效果

      int i = 0;
      i = 1;
      for (int i = 0; i < 100; i++)
      {
         printf("hello markdown!\n");
      }
      

6. 分隔线

   用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西

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

   渲染后效果

   ---

   ---

   ---

   ---

   ---

   可以看到效果都是一样的

7. 链接

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

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

     This is [an example](http://example.com/ "Title") inline link.
     [This link](http://example.net/) has no title attribute.
   

   渲染后

   This is an example inline link.
   This link has no title attribute.

   参考式

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

     This is [an example][id] reference-style link.
   

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

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

   链接内容定义的形式为：

   • 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
   • 接着一个冒号
   • 接着一个以上的空格或制表符
   • 接着链接的网址
   • 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

   *隐式链接标记功能让你可以省略指定链接标记*

   这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号，如果你要让 "Google" 链接到 google.com，你可以简化成:

   [Google][]
   

   然后定义链接内容：

   [Google]: http://google.com/
   

8. 强调

   Markdown 使用星号（*）和底线（_）作为标记强调字词的符号

   *single asterisks*
   _single underscores_
   **double asterisks**
   __double underscores__
   

   渲染后效果

   single asterisks
   single underscores
   double asterisks
   double underscores

   注意： 如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号

9. 图片
   Markdown 插入图片允许两种样式： 行内式和参考式

   行内式的图片语法

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

   详细叙述如下：

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

   效果：
   

   ---

   参考式

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

10. 其他
    自动链接

    Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接

    效果

    转义符

    Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号

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

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

    ---

    好了，MarkDown的简单的用法规则就是这些，掌握好这些，平时再多加练习，就可以写出漂亮的格式

来自为知笔记(Wiz)