Markdown语法总结

  • A+
所属分类：系统文档

0.目录（Table of Contents）

在需要目录出现的地方放置一个标记，这样会自动生成一个嵌套的包含所有标题的列表。默认的标记是 [TOC]。

[TOC]

注：简书不支持该语法，Typora、马克飞象、Cmd Markdown等编辑器支持。

1.标题（Headers）

Markdown 标题支持两种形式：

1.1用1~6个#标记

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

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

一级标题

二级标题

三级标题

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

1.2用=和-标记

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

一级标题
======

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

一级标题

二级标题

2.列表（Lists）

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

2.1无序列表（Unordered Lists）

无序列表使用-、+和*作为列表标记：

-  Red
- Green
- Blue

* Red
* Green
*  Blue

+  Red
+ Green
+ Blue
  • Red
  • Green
  • Blue
  • Red
  • Green
  • Blue
  • Red
  • Green
  • Blue

2.2有序列表（Ordered Lists）

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

  1. Red
  2. Green
  3. Blue

3.引用（Reference）

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

3.1常见的引用写法：

> 这是一段引用    
> 
>     这是引用的代码块形式

这是一段引用 //在>后面有 1 个空格

> 代码例子：
>   
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

代码例子：

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

3.2分级引用

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

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

一级引用

二级引用

三级引用

这是一个四级标题

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

建立多级列表时，每个子级别都要比上个级别前面多打2个以上空格。
在 「 * 」 前加两个空格键或者一个 tab 键就可以产生一个子列表。
有序列表： 在文本前加 「字母.」 或 「数字.」 即可生成一个有序列表。
注意，当你第一个序号使用什么作为标记的，那么同级别的列表就会自动使用其作为标记。

4.文字样式（Text Styling）

4.1. 基本语法

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

**加粗文本** 或者 __加粗文本__
*斜体文本*  或者　_斜体文本_
***斜粗体*** 或者 ___斜粗文本___
~~删除文本~~
 :==高亮 
` 底纹 `

加粗文本 或者 加粗文本
斜体文本 或者　斜体文本
斜粗体 或者 斜粗文本
删除文本
:==高亮 #807700==或者==高亮==
底纹

4.2.非基本语法

字体上标（superscript）和下标（subscript ）

4.2.1简书中，字体上、下标的语法为：

<sup>上标文字</sup>
<sub>下标文字</sub>

上标文字
下标文字
这是上标文字
这是下标文字

4.2.2Typora 中，字体上、下标的语法为：

这是上标文字
这是下标文字

5.图片与链接（Images & Links）

图片与链接的语法很像，区别在一个 ! 号。
注：Markdown 不能设置图片大小，如果必须设置则应使用HTML标记 <img>

图片：![]() ![图片描述(可忽略)](链接的地址)
链接：[]() [链接描述](链接的地址)

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

This is an example inline link.
This link has no title attribute.

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

内联（Inline）：以中括号[]标记显示的链接文本，后面紧跟用小括号()包围的链接。 如果链接 Title 属性，则在链接中使用空格加"Title 属性"，即Title。

这是行内式链接：[Mou](http://25.io/mou/)。

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

[url]: 25.io/mou/

这是行内式链接：Mou。

这是参考式链接：Mou，其中url为链接标记，可置于文中任意位置。

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

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

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

这是图片：![][Mou icon]

[Mou icon]: http:

这是图片：

添加图片的使用方法基本上和链接类似，只是在中括号前加叹号!，即![Image Title](URL "Image Title")。

6.代码块引用（Fenced Code Blocks）

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

6.1行内代码

行内代码使用 代码 标识，可嵌入文字中
需要引用代码时，如果引用的语句只有一段，不分行，可以用 ` 将语句包起来。

Hello world

6.2代码框

两对「 」包裹,如果引用的语句为多行，可以将 置于这段代码的首行和末行。
代码前加四个空格键
代码前加一个 tab 键

​```
Code Line 1
Code Line 2
Code Line 3
​```

Code Line 1
Code Line 2
Code Line 3

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

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

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

7.表格（Tables）

表格对齐格式
居左：:----
居中：:----:或-----
居右：----:
例子：

|标题|标题|标题|
|:---|:---:|---:|
|居左文本|居中文本|居右文本|
标题 标题 标题
居左文本 居中文本 居右文本

8.分隔线

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

效果均为一条分割线

9.脚注|注解（Footnotes）

9.1使用[^]来定义脚注：

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

这是一个脚注的例子

9.2注释

注释是给自己看的，预览时也不会出现，当然发布出去别人也不会看见。

10.常用弥补Markdown的Html标签

10.1字体

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

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

10.2换行

使用html标签<br/>
换行

10.3文本对齐方式

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

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

10.4下划线

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

11.任务列表

- [ ] [links](), **formatting**, and ~~tags~~ supported
- [x] list syntax required (any unordered or ordered list supported)
- [ ] this is a complete item
- [x] this is an incomplete item
  • [ ] links, formatting, and tags supported
  • [x] list syntax required (any unordered or ordered list supported)
  • [ ] this is a complete item
  • [x] this is an incomplete item
    注：简书不支持该语法，Typora、Day One 2、马克飞象、Cmd Markdown等编辑器支持。

12.转义字符（Backslash Escapes）

Markdown 可以利用反斜杠\来插入一些在语法中有其它意义的符号，例如：如果想要用星号加在文字旁边的方式来做出强调效果，可以在星号的前面加上反斜杠：

*literal asterisks*

  1. 这里是脚注 ↩

  • 我的微信
  • 这是我的微信扫一扫
  • weinxin
  • 我的微信公众号
  • 我的微信公众号扫一扫
  • weinxin