Markdown 基本语法

1.段落    

     一行文字就是一个段落。

     如果要需要另起一段,请在两个段落之间隔一个空行。

2.粗体 、斜体    

     *这是斜体*

     _这也是斜体_

     **这是粗体**

     ***这是粗体+斜体***

3.删除线

     就像这样

4.标题   

markdown总支持1~6六级标题,通过在一行之前加上不同数量的井号来表示。

     # 这是 H1 #

     ## 这是 H2 ##

     ### 这是 H3 ###

     ...

     ###### 这是 H6 ######

5.引用

通过在行首加上大于号 > 来添加引用格式。

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

     也可以嵌套其他格式:

     > ## 这是一个标题。

     > >  1. 这是第一行列表项。

     > 2. 这是第二行列表项。

     >>  给出一些例子代码:

6.列表     

无序列表使用星号、加号或是减号作为列表标记:

     * Red

     * Green

     * Blue

有序列表则使用数字接着一个英文句点:

     1. Bird

     2. McHale

     3. Parish

7.内联代码     

用反引号 ` 来标记内联代码。如果代码的内容中有反引号,请用两个反引号包裹。

8.代码区域      

有两种方式标记代码区域:

原生风格是行首缩进4个空格。

     这是一个普通段落:

          这是一个代码区块

github的风格,代码段的前后用三个反引号独占一行来标记。

     ```

     代码块

     ```

9.分隔线     

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面 每种写法都可以建立分隔线:

     * * *

     ***

     *****

     - - -

10.链接      

     [an example](http://example.com/)

     [an example](http://example.com/ "Optional Title")

     会被解释为

     an example

     an example

11.图像

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

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

     会被解释为

     Alt text

     Alt text

12.转义

markdown支持在以下字符前面插入反斜杠

     \ 反斜线

     ` 反引号

     * 星号

     _ 底线

     {} 花括号

     [] 方括号

     () 括弧

     # 井字号

     + 加号

     - 减号

     . 英文句点

     ! 惊叹号

插入之后,将不再解析这些字符,而是原样输出。

13.表格

表格是github风格独有的语法,但近年来渐渐被大多数编辑器支持。

     | Item     | Value | Qty   |

     | :------- | ----: | :---: |

     | Computer | $1600 | 5     |

     | Phone    | $12   | 12    |

     | Pipe     | $1    | 234   |

     会被解释成

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

Item Value Qty
Computer $1600 5
Phone $12 12
Pipe $1 234

要注意第二行的冒号决定了居左居右还是居中,如果你不加冒号,默认是居左的。

另外可以把第一行去掉,做成没有表头的表格,但第二行始终是要有的。

14.内联 HTML   

Markdown 的语法简洁,但有其局限性,所以特意保留了内联html这种方式。任何html标签及其内容,都会原样输出到结果中。也就是 说,标签中的星号等作为markdown结构的符号,以及构成html标签和实体的符号,都不会做任何转义。

评论

暂无评论