Cardinfolink 讯联数据

markdown 的基本语法

2016-11-10
ChenFeng

一. 简单功能

功能 效果 Markdown代码 备注
粗体 粗体 **粗体** 两边加**
斜体 斜体 *斜体* 两边加*
中划线 中划线 <S>中划线</S> html标签<S>
单行代码 Log.i("Hello World!") `Log.i(“Hello World!”)` 两边加``
插入图片 Image ![Image](http://www.trinea.cn/rss.png) [] 中间为占位符,() 中间为图片链接
链接 Visit Github [Visit Github](http://www.github.com) [] 中间为显示文字,() 中间为链接

二. 其他功能

1. 换行

在需要换行的地方敲击两次空格和一个回车键即可,如:

这是第一行(空格)(空格)(回车)
这是第二行

Tips: 多条新行都会被视为一行

2. 标题

Markdown 提供了六种规格的标题,分别对应 Html 标签中的<h1>-<h6>,通过添加不同数量的#字符可以实现不同大小的标题,如:

# 最大的标题(相当于一个<h1>标签)

## 次大的标题(相当于一个<h2>标签)

...

###### 最小的标题(相当于一个<h6>标签)

Tip: # 越多,标题越小

3. 列表

3.1 有序列表

数字 + . + 空格即可,以下代码:

1. 项目1  
2. 项目2  
3. 项目3  

效果为:

  1. 项目1
  2. 项目2
  3. 项目3

3.2 无序列表

以 * 和空格开头即可,以下代码:

* 项目1
* 项目2
* 项目3

效果为:

  • 项目1
  • 项目2
  • 项目3

3.3 子项目表示:

子项目缩进一个 tab 并加 * 和 空格表示,以下代码:

* 项目1
    * 子项目1
    * 子项目2
* 项目2
    * 子项目1

效果为:

  • 项目1
    • 子项目1
    • 子项目2
  • 项目2
    • 子项目1

4. 代码块

以 ``` 和 ``` 包含,以下代码:


```
def hello():
    print 'Hello World!'
```

效果为:

def hello():
    print 'Hello World!'

GFM 扩展了 Markdown 的代码块功能,通过在上面第一个 ``` 后添加语言名称,使不同语言展现不同的代码高亮风格,以下代码:


```java
public static void main(String[] args){
    System.out.println("Hello World!");
}
```

效果为:

public static void main(String[] args){
    System.out.println("Hello World!");
}

以下代码:



```python
def hello():
    print 'Hello World!'
```

效果为:

def hello():
    print 'Hello World!'

5. 表格

标准的 Markdown 中并不支持表格,但 GFM 可以,表头前空一行,以 --- 做为表头分隔,以 | 做为列分隔,以下代码:

表头1|表头2
---|---
单元格1|单元格2
单元格3|单元格4

效果为:

表头1 表头2
单元格1 单元格2
单元格3 单元格4

而且还可以通过在表头分隔符中添加 : 来决定单元格的对齐方向,以下代码:

表头1|表头2|表头3
:--|:--:|--:
左1|中1|右1
左2|中2|右2

效果为:

表头1 表头2 表头3
左1 中1 右1
左2 中2 右2

6. 特殊字符转义

如果需要在正文里使用特殊字符的话,可以用 \ 来转义
最后 GFW 支持 Html 标签


相关文章

分享

评论