Markdown 语法详尽笔记大全 2019

2021-10-31 09:46:48

0.介绍
1.快捷键
- 写法1 #
- 写法2 上下文标题

[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
AAA		CCC
DDD		CCC

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 本身是不支持修改字体、字号与颜色等功能的！

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>`
上标	Z^a	`Z<sup>a</sup>`
下标	Z_a	`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}}$$

!注意:

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

码农公寓

写法1 #