Markdown的常用语法

简介

Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。
注意:Markdown使用#+*等符号来标记, 符号后面必须跟上 至少1个 空格才有效!

Markdown的常用语法

标题

Markdown 标题支持两种形式:

  • #标记

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

# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
  • =-标记
    在 标题底下 加上任意个=代表一级标题,-代表二级标题

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表

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

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

- 昨天
- 今天
- 明天

* 昨天
* 今天
* 明天

+ 昨天
+ 今天
+ 明天

效果如下:

  • 昨天
  • 今天
  • 明天

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

1. 昨天
2. 今天
3. 明天

效果如下:

  1. 昨天
  2. 今天
  3. 明天

引用

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

常见的引用写法:

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

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

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

效果如下:

这是一段引用

这是引用的代码块形式

代码例子:

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

一级引用

二级引用

三级引用

这是一个四级标题

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

字体

  • 加粗
    要加粗的文字左右分别用两个*号包起来
  • 斜体
    要倾斜的文字左右分别用一个*号包起来
  • 斜体加粗
    要倾斜和加粗的文字左右分别用三个*号包起来
  • 删除线
    要加删除线的文字左右分别用两个~~号包起来
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字


分割线

三个或者三个以上的 - 或者 * 都可以。

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

效果示例





图片与链接

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

![图片alt](图片地址 ''图片title'')

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

效果如下:

美女图


表格

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

效果如下:

请求参数名请求类型参数必填
usernamestring
passwordstring

代码

语法:
单行代码:代码之间分别用一个反引号包起来

 `代码内容`

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

   (```)
     代码...
     代码...
     代码...
   (```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

示例
单行代码
代码内容
代码块

     代码...
     代码...
     代码...

超链接

[超链接名](超链接地址 "超链接title")
title可加可不加

效果如下
百度
Giles'Blog

标签: MarkDown

发表评论: