Markdown 新手指南

简介

Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。

注意:Markdown使用#+*等符号来标记, 符号后面必须跟上 至少1个 空格才有效!

Markdown的常用语法

标题

Markdown 标题支持两种形式:

1、用#标记

标题开头 加上1~6个#,依次代表一级标题、二级标题....六级标题

# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题

2、用=-标记

标题底下 加上任意个=代表一级标题,-代表二级标题

一级标题
======

二级标题
----------

效果如下:

一级标题

二级标题

三级标题

四级标题
五级标题
六级标题

列表

Markdown 支持有序列表和无序列表。

无序列表使用-+*作为列表标记:

- Red
- Green
- Blue

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

效果如下:

  • Red
  • Green
  • Blue

有序列表则使用数字加英文句点.来表示:

1\. Red
2\. Green
3\. Blue

效果如下:

  1. Red
  2. Green
  3. Blue

引用

引用以>来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。

常见的引用写法:

> 这是一段引用    //在`>`后面有 1 个空格
> 
>     这是引用的代码块形式    //在`>`后面有 5 个空格
>     
> 代码例子:
>   
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

> 一级引用
> > 二级引用
> > > 三级引用

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

效果如下:

这是一段引用

这是引用的代码块形式    //在`>`后面有 5 个空格

代码例子:

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

一级引用

二级引用

三级引用

这是一个四级标题

  1. 这是第一行列表项
  2. 这是第二行列表项

以下是分割线


强调

两个*-代表加粗,一个*-代表斜体,~~代表删除。

**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

~~删除文本~~

效果如下:

加粗文本 或者 加粗文本

斜体文本 或者 斜体文本

删除文本


图片与链接

图片与链接的语法很像,区别在一个 ! 号。二者格式:

图片:![]()    ![图片文本(可忽略)](图片地址)

链接:[]()     [链接文本](链接地址)

链接又分为行内式参考式自动链接

这是行内式链接:[ConnorLin's Blog](http://connorlin.github.io)。

这是参考式链接:[ConnorLin's Blog][url],其中url为链接标记,可置于文中任意位置。

[url]: http://connorlin.github.io/ "ConnorLin's Blog"

链接标记格式为:[链接标记文本]:  链接地址  链接title(可忽略)

这是自动链接:直接使用`<>`括起来

这是图片:![][avatar]

[avatar]: https://connorlin.github.io/images/avatar.jpg

效果如下:

这是行内式链接:ConnorLin's Blog。

这是参考式链接:ConnorLin's Blog,其中url为链接标记,可置于文中任意位置。

这是自动链接:直接使用<>括起来http://connorlin.github.io

这是图片:

image

代码

代码分为行内代码代码块

  • 行内代码使用 代码 标识,可嵌入文字中

  • 代码块使用4个空格或```标识

    这里是代码
    
  • 代码语法高亮在 ```后面加上空格和语言名称即可

    //注意语言前面有空格
    这里是代码
    

例如:

这是行内代码`onCreate(Bundle savedInstanceState)`的例子。

这是代码块和语法高亮:

``` java
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

效果如下:

这是行内代码`onCreate(Bundle savedInstanceState)`的例子。

这是代码块和语法高亮:

// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}


## **表格**

表格对齐格式

*   居左:`:----`
*   居中:`:----:`或`-----`
*   居右:`----:`

例子:

标题 标题 标题
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33
居左测试文本111 居中测试文本222 居右测试文本333

效果如下:

| 标题 | 标题 | 标题 |
| --- | --- | --- |
| 居左测试文本 | 居中测试文本 | 居右测试文本 |
| 居左测试文本1 | 居中测试文本2 | 居右测试文本3 |
| 居左测试文本11 | 居中测试文本22 | 居右测试文本33 |
| 居左测试文本111 | 居中测试文本222 | 居右测试文本333 |

* * *

## **分隔线**

在一行中用三个以上的`*`、`-`、`_`来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。






效果均为一条分割线:

* * *

* * *

## **换行**

在行尾添加两个空格加回车表示换行:

这是一行后面加两个空格 换行


效果如下:

这是一行后面加两个空格
换行

* * *

## **脚注(注解)**

使用`[^]`来定义脚注:

这是一个脚注的例子[1]


效果如下:

这是一个脚注的例子[[1]](#fn1)

* * *

# **常用弥补Markdown的Html标签**

## **字体**

字体及字体颜色和大小
字体颜色


效果如下:

字体及字体颜色和大小
字体颜色

* * *

## **换行**

使用html标签

换行


效果如下:

使用html标签`
` 换行 * * * ## **文本对齐方式**

居左文本


居中文本


居右文本


效果如下:

居左文本

居中文本

居右文本

* * * ## **下划线**

下划线文本

标题

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

你可以你的编辑器中尝试输入这六级标题,可以参考下方的截图:

image

列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:

- 文本1
- 文本2
- 文本3

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了,例如:

1\. 文本1
2\. 文本2
3\. 文本3

注:-1.和文本之间要保留一个字符的空格。

列表案例截图如下:

image

链接和图片

在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址) 这样的语法即可,例如:

[](http://www.jianshu.com)

在 Markdown 中,插入图片不需要其他按钮,你只需要使用 [图片上传失败...(image-abcaf9-1601363065976)] 这样的语法即可,例如:

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注:插入图片的语法和链接的语法很像,只是前面多了一个

插入链接和图片的案例截图:

image

引用

在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:

> 一盏灯, 一片昏黄; 一, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

注:> 和文本之间要保留一个字符的空格。

最终显示的就是:

一盏灯, 一片昏黄; 一, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

引用的案例截图:

image

粗体和斜体

Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。例如:

 *一盏灯*, 一片昏黄;**一**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

最终显示的就是下文,其中「一盏灯」是斜体,「一」是粗体:

一盏灯, 一片昏黄;, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

粗体和斜体的案例截图:

image

代码引用

需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
如果引用的语句为多行,可以将```置于这段代码的首行和末行。
代码引用的案例截图:

image

表格

相关代码:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

显示效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1


相关代码:

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

显示效果:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

显示链接中带括号的图片

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20(n_{i})+1

代码如下:

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1


  1. 这里是脚注 ↩

你可能感兴趣的:(Markdown 新手指南)