Markdown的常用语法

 · 2020-5-28 · 次阅读

前言：Markdown是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。

优点：

1、因为是纯文本，所以只要支持Markdown的地方都能获得一样的编辑效果，可以让作者摆脱排版的困扰，专心写作。
2、操作简单。比如:WYSIWYG编辑时标记个标题，先选中内容，再点击导航栏的标题按钮，选择几级标题。要三个步骤。

缺点：
1、需要记一些语法（当然，是很简单。五分钟学会）。
2、有些平台不支持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

效果如下

. Red
. Green
. 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.这是第二行列表项

以下是分割线

强调

两个或-代表加粗，一个或-代表斜体，~~代表删除。

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

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

~~删除文本~~

效果如下：

加粗文本或者加粗文本
x斜体文本或者斜体文本
删除文本

图片与链接

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

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

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

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

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

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

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

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

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

这是图片：![](avatar)

(avatar): https://connorlin.github.io/images/avatar.jpg

效果如下：

这是行内式链接：5ibby_Blog

这是参考式链接：[5ibby_Blog][http://5ibby.github.io/]，其中url为链接标记，可置于文中任意位置。

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

这是图片：图片

代码

代码分为行内代码和代码块。

. 行内代码使用 代码 标识，可嵌入文字中

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

  这里是代码

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

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

例如：

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

这是代码块和语法高亮：

``` java
// 注意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
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33

分隔线

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

***
---
___

* * *

效果均为一条分割线：

换行

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

效果如下：
这是一行后面加两个空格
换行

脚注(注解)

使用[^]来定义脚注：

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

[^1]: 这里是脚注

效果如下：
这是一个脚注的例子[^1]
[^1]: 这里是脚注

常用弥补Markdown的Html标签

字体

<font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

效果如下：

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

换行

使用html标签`<br/>`<br/>换行

效果如下：

使用html标签

换行

文本对齐方式

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

效果如下：

居左文本


居中文本


居右文本

下划线

<u>下划线文本</u>

效果如下：

下划线文本

超链接

[网址名](网址)

效果如下：
百度
CSDN

markdown进阶

插入视频

src里面填视频原URL
width是视频宽度（可以填百分比）
height是视频高度（可以填百分比）

<iframe 
    width=80%
    height=600px
    src='//player.bilibili.com/player.html?aid=455564468&bvid=BV1H541147nA&cid=187808769&page=1'
    frameborder="0" 
    allowfullscreen>
</iframe>

文字缩进

在要缩进的文字前使用   （注意空格）
示例
这是缩进前的文字
&emsp这是缩进后的文字

文字的居中

对于标准的markdown文本，是不支持居中对齐的。但是markdown支持html语言，所以我们采用html语法格式来实现

<center>这一行需要居中</center>
这一行需要居中

==== 等等……

赏