Markdown 语法详尽笔记大全 2019

小程序：扫一扫查出行
【扫一扫了解最新限行尾号】
复制小程序

[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.快捷键

#

 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
:-:|:- |-:
居中 | 左对齐 | 右对齐
============|=================|=============


居中 | 左对齐 | 右对齐


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

特殊写法

  对于合并单元格，以及其他特殊格式表格，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>


 2.7 超链接

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


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

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


示例

链接

写法1：<超链接>

• 自动连接
  
  只要是用<>包起来，Markdown就会自动把它转成链接。
  
  也可以直接写，也是可以显示成链接形式的

写法2：[]()

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


写法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
 Hello World
 Hello World
 Hello World
 Hello World
 Hello World
 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>测试了支持度不够良好,不建议使用 :)


示例

 3.3 内嵌 HTML 语句

HTML 中的语义标签

格式化文本 <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工具或者网站都不支持。

平台支持性

示例

#

 4. 高端用法

##

 4.1 脚注 与 Latex数学公式

### 注脚 `[^注脚名]`
```
引用脚注: [^注脚名]
添加脚注: [^注脚名]:

语法说明：

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

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

注意：

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

我在这里要引用一个注脚[^0][^0]:我在这里对注脚进行添加注释### Latex数学公式 `\$`
#### 行内公式


$公式$

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

输入 $\sqrt{x^{2}}$#### 行间公式


$$公式$$

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

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

!注意:

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