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 字体、字号 与 颜色
    • ****-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
 Hello World
 Hello World
 Hello World
 Hello World
 Hello World
 Hello World

 3.2 字体、字号 与 颜色

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

****-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}}$$

!注意:

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