Markdown 语法详尽笔记大全 2019

0.介绍
1.快捷键
- 写法1 #
- 写法2 上下文标题
- 2.2 字体设置斜体、粗体、删除线 _*~
- 2.3 分割线 --- 或 ***
- 2.4 引用 >
  - 示例:
- 2.5 列表
  - 无序列表 *，+，-
    - 示例
  - 有序列表
  - 列表的嵌套
    - 示例
  - 定义型列表
    - 示例
  - 列表的注意事项
- 2.6 表格
  - 标准写法
  - 简约写法
  - 特殊写法
- 2.7 超链接
  - 图片链接 ![描述](地址)
    - 示例
  - 链接
    - 写法1：<超链接>
    - 写法2：[]()
    - 写法3：HTML代码
- 2.8 代码块
  - 单行代码
  - 代码块
  - 自定义语法
- 3.2 字体、字号与颜色
  - CSDN-markdown编辑器
    - 示例
  - 背景色
    - 示例
- 3.3 内嵌 HTML 语句
  - HTML 中的语义标签
  - 格式化文本
  - 支持内嵌CSS样式
- 3.4 特殊字符
  - Markdown 中的语法符号
  - 其他特殊字符
- 3.5 内容目录和锚点
  - 内容目录 [TOC]
  - 锚点
- 3.6 emoji表情符号
  - 平台支持性
  - 示例

[Fuck me in Gitee](https://gitee.com/lin_river/NoteForMarkdown/blob/master/note%20for%20markdown.md)

[Fuck me in Github]( https://github.com/lin-river/markdownNote/blob/master/markdown/markdown.md )

0.介绍

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过类似HTML的标记语法，它可以使普通文本内容具有一定的格式。

1.快捷键

功能	快捷键
加粗	Ctrl + B
斜体	Ctrl + I
引用	Ctrl + Q
插入链接	Ctrl + L
插入代码	Ctrl + K
插入图片	Ctrl + G
提升标题	Ctrl + H
有序列表	Ctrl + O
无序列表	Ctrl + U
横线	Ctrl + R
撤销	Ctrl + Z
重做	Ctrl + Y

2.基本语法

2.1 分级标题 `#`

- 一般 `#` 作为文章大标题，只有一个，`###` 作为段落标题。

写法1 `#`

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

写法2 上下文标题

这是一个一级标题
============================

这是一个二级标题
----------------------------

注意：###### 六级标题 和 **文字** 效果是一样的

2.2 字体设置斜体、粗体、删除线

_*~

代码	显示结果
正常文字	正常文字
`文字倾斜`	文字倾斜
`_文字倾斜_`	文字倾斜
`文字加粗`	文字加粗
`*文字倾斜加粗*`	文字倾斜加粗
`~~文字下划线~~`	文字下划线

注意不能有空格

2.3 分割线

--- 或 ***

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

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

2.4 引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

示例:

这是引用的内容
这是引用的内容
这是引用的内容

2.5 列表

无序列表 `*，+，-`

使用 *，+，- 表示无序列表。 注意：符号后面一定要有一个空格，起到缩进的作用。

- 无序列表内容
+ 无序列表内容
* 无序列表内容

示例

无序列表内容

无序列表内容

无序列表内容

有序列表

使用数字和一个英文句点表示有序列表。 注意：英文句点后面一定要有一个空格，起到缩进的作用。

1.有序列表内容 
2.有序列表内容
3.有序列表内容

列表的嵌套

上一级和下一级之间敲三个空格即可，或一个tab

- 列表的嵌套
    - 上一级和下一级之间敲三个空格即可

示例

列表的嵌套
- 上一级和下一级之间敲三个空格即可

定义型列表

语法格式：

事物
:   事物的定义

Markdown 
:   轻量级文本标记语言，可以转换成html，pdf等格式  //  开头一个`:` + `Tab` 或 四个空格

代码块定义
:   代码块定义……

        var a = 10;         // 保持空一行与 递进缩进

示例

Markdown

轻量级文本标记语言，可以转换成html，pdf等格式 // 开头一个

Tab

或四个空格

代码块定义

代码块定义……

var a = 10;         // 保持空一行与 递进缩进

列表的注意事项

列表中包含代码块
- 前面加2个tab或者8个空格，并且需要空一行，否则不显示
列表的转义
- 在使用列表时，只要是数字后面加上英文的点，就会无意间产生列表
- 比如2017.12.30 这时候想表达的是日期，有些软件把它被误认为是列表。
- 解决方式：在每个点前面加上\就可以了

2.6 表格

表格对齐方式：
    冒号在左边表示左对齐
    冒号右边表示有对齐
    冒号两边都有表示居中

标准写法

|    a    |       b       |      c     |
|:-------:|:------------- | ----------:|
|   居中  |     左对齐    |   右对齐   |
|=========|===============|============|

a	b	c
居中	左对齐	右对齐
=========	===============	============

简约写法

a  | b | c  
:-:|:- |-:
    居中    |     左对齐      |   右对齐    
============|=================|=============

a	b	c

居中    |     左对齐      |   右对齐

|=|=========

特殊写法

对于合并单元格，以及其他特殊格式表格，markdown 是无能为力的

所以常规的做法是使用HTML标签，但是这样的编写效率极低。

但是有了以下这款工具的话，所有问题都迎刃而解。

在线生成HTML代码 Tables Generator (国外的站)

<table class="tg">
  <tr>
    <th class="tg-0pky" rowspan="2">AAA</th>
    <th class="tg-0pky" colspan="2">BBB</th>
  </tr>
  <tr>
    <td class="tg-0pky"></td>
    <td class="tg-fymr" rowspan="2">CCC</td>
  </tr>
  <tr>
    <td class="tg-0pky" colspan="2">DDD</td>
  </tr>
</table>

AAA	BBB
CCC
DDD

2.7 超链接

!注意：
    {:target="_blank"} 跳转方式兼容性一般 ，多数第三方平台不支持跳转

图片链接 `![描述](地址)`

![图片描述](图片地址 \'图片title\') 
    图片title是图片的标题，当鼠标移到图片上时显示的内容。
    图片title可加可不加

示例

链接

写法1： `<超链接>`

自动连接

只要是用<>包起来，Markdown就会自动把它转成链接。

也可以直接写，也是可以显示成链接形式的

代码	显示结果
`http://jianshu.com`	http://jianshu.com
`<http://baidu.com>`	http://baidu.com

写法2： `[]()`

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

代码	显示结果
`[简书](http://jianshu.com)`	简书
`[百度](http://baidu.com)`	百度

写法3：HTML代码

<a href="超链接地址" target="_blank">超链接名</a>
注：  
    Markdown本身语法不支持链接在新页面中打开   
    如果想要在新页面中打开的话可以用html语言的a标签代替。

超链接名

2.8 代码块

单行代码

代码之间分别用一个反引号包起来 代码内容

代码块

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

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

自定义语法

如 javascript，python，markdown...

print("hello world!")

3.常用技巧

3.1 换行与缩进

### 换行 `\

```

方法1: 连续两个以上空格+回车

方法2：使用html语言换行标签：

```

### 缩进字符

```

不断行的空白格

半角的空格

全角的空格

```

或

```

或缩进 1/4 中文

或缩进 1/2 中文，一个字符

或缩进 1/1 中文，两个字符

```

#### 示例

Hello World

3.2 字体、字号与颜色

Markdown 本身是不支持修改字体、字号与颜色等功能的！

CSDN-markdown编辑器

是 Markdown 衍生版本，扩展了 Markdown 如表格、脚注、内嵌HTML等等的功能
接下来要讲的功能就需要使用内嵌HTML的方法来实现。

face : 字体样式
<font face= "华文彩云">华文彩云</font> 
  
color : 可以用十六位颜色值，也可以用已知颜色名
<font color="#f00">标红字体</font> 

size : 规定文本尺寸大小,可能值从 1~7，浏览器默认值为 3
<font size="1">1号尺寸</font>

示例

微软雅黑

华文彩云

标红字体

1号尺寸

背景色

Markdown 本身不支持背景色设置,需要采用内置html的方式实现
借助 table, tr, td 等表格标签的 bgcolor 属性来实现背景色的功能

    <table>
      <tr>
        <td bgcolor=orange>背景色是：orange</td>
      </tr>
    </table>

测试了支持度不够良好,不建议使用 :)

示例

背景色是：orange

3.3 内嵌 HTML 语句

HTML 中的语义标签

描述	效果	代码
斜体	斜体	`<i>斜体</i>`
加粗	加粗	`<b>加粗</b>`
强调	强调	`<em>强调</em>`
上标	Za	`Z<sup>a</sup>`
下标	Za	`Z<sub>a</sub>`
键盘文本	Ctrl	`<kbd>Ctrl</kbd>`

格式化文本 `<pre></pre>`

保持输入排版格式不变

<pre>
hello world 
         hi
  hello world 
</pre>

hello world 
         hi
  hello world

支持内嵌CSS样式

内联样式

3.4 特殊字符

Markdown 中的语法符号

前面加反斜线\即可显示符号本身。

代码	显示结果
反斜线 `\\`	\
星号 `\*`	*
井号 `#`	#
加号 `+`	+
减号 `-`	-
英文句号 `.`	.
英文惊叹号 `!`	!
括号 `\{\}\[\]`	{}[]()

其他特殊字符

代码	显示结果
`❤`	❤
`✓`	✓
`☀`	☀
`★`	★
`❄`	❄
`✓`	☂
`☢`	☢
`☎`	☎
`♫`	♫
`∞`	∞

想知道字符对应的Unicode码，可以看这个网站：https://unicode-table.com/cn/

3.5 内容目录和锚点

内容目录 `[TOC]`

在段落中填写 [TOC] 根据标题生成目录，兼容性一般

锚点

锚点其实就是页内超链接

插入锚点: {#标记名}
跳转锚点: [描述](#index)

语法说明： 
在你准备跳转到的指定标题后插入锚点{#标记}
然后在文档的其它地方写上连接到锚点的链接。

!注意：
    只有标题支持锚点， 跳转目录方括号后 保持空格
    测试了支持度不够良好,不建议使用 :)

跳转到目录

3.6 emoji表情符号

emoji表情使用:EMOJICODE:的格式，详细列表可见

https://www.webpagefx.com/tools/emoji-cheat-sheet/
当然现在很多markdown工具或者网站都不支持。

平台支持性

工具或网站	是否支持emoji表情符号
简书	否
MarkDownPad	否（不知道付费版是否支持）
有道云笔记	否
zybuluo.com	否
github	是

示例

4. 高端用法

4.1 脚注与 Latex数学公式

### 注脚 `[^注脚名]`

```

引用脚注: [^注脚名]

添加脚注: [^注脚名]:

语法说明：

在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。

可在文本的任意位置添加脚注，脚注前必须有对应的脚注名字

注意：

脚注自动被搬运到最后面，请到文章末尾查看。
脚注后方的链接可以直接跳转回到加注的地方。

我在这里要引用一个注脚[^0]

[^0]:我在这里对注脚进行添加注释


### Latex数学公式 `\$`
#### 行内公式

$公式$

使用两个”$”符号引用公式:

输入 $\sqrt{x^{2}}$

#### 行间公式

$$公式$$

使用两对“$$”符号引用公式：

输入 $$\sqrt{x^{2}}$$

!注意:

测试了支持度不够良好,不建议使用