【Markdown】基础语法总结

---

前言

Markdown 是一种轻量级标记语言，排版语法简洁，初衷是让人们更多地关注内容本身而非排版。可与HTML混编，可导出 HTML、PDF 以及 .md 后缀格式的文件。

Markdown有基础语法与扩展语法之分，扩展语法是基础语法的超集，以适应更加复杂的需求。扩展语法不一定能被所有Markdown编辑器所兼容。CSDN实现了Markdown编辑器，并拓展了一些新的样式，也一并介绍。

本文参考Markdown 官方教程撰写👍。

---

标题语法

# title1    // 一级标题
## title2   // 二级标题

#与标题之间填充空格，#的个数决定标题的级数。

---

分割线语法

---         // 分割线

为了兼容不同的编辑器，注意前后各空一行。

---

段落语法

分段

段与段之间空一行，类似于Latex。

---

换行

空两格回车（CSDN中貌似直接回车即可），或使用HTML语法中的<br>标签。

---

缩进

空格与制表符都无法实现缩进，这与Word之类的富文本编辑器不同。

通过HTML语法可以实现缩进

   // 表示添加一个tab位置

效果为
  Hello world

或可以尝试使用自定义列表实现缩进，该语法为扩展语法。语法为

首行
: 缩进1        // 缩进
: 缩进2         

效果为

首行

缩进1

缩进2

---

强调文本

粗体

效果为 Bold

**Bold**      // 加粗

等效HTML语法为<b>标签

<b>Bold</b>

---

斜体

*Italic*     // 斜体

效果为 Italic

---

粗体&斜体

***text***    // 粗体&斜体

效果为 text

---

高亮（CSDN）

在CSDN中可以使用该语法

==Highlight==    // 高亮

效果为 Highlight

---

删除线（扩展语法）

~~delete~~    // 删除线

效果为 delete

---

上下标（CSDN）

在CSDN中可以使用该语法

H~2~O    // 下标
2^10^    // 上标

效果为：H₂O、2¹⁰

---

超链接

title可选，悬停显示。

[添加链接描述](url "title") 

这是通向GitHub的链接。

---

网页&邮箱

<url> 

这是通向 http://baidu.com 的链接。

---

引用语法

>quote     // 引用

效果为

quote

---

引用嵌套

>quote     // 引用
>>quote

效果为

quote

quote

---

参考文献引用（扩展语法）

即脚注。

效果见文末^[foot]    // 脚注

效果见文末¹

---

列表语法

有序列表

1. xxx    // 有序列表
2. xxx

效果为

1. xxx
2. xxx

---

无序列表

- xxx    // 无序列表
- xxx

效果为

• xxx
• xxx

---

任务列表（扩展语法）

- [ ] List item    // 待选
- [x] List item    // 已选

效果为

• List item
• List item

---

列表嵌套

- xxx       // 列表嵌套
	1. xxx  

效果为

• xxx
  1. xxx

---

代码语法

单行代码

效果为code

`code`       // 单行代码 

等效为HTML中的<code>标签

<code>code</code>

---

代码块（扩展语法）

```python
print("Hello World!")    
```

支持语法高亮，效果为

print("Hello World!")

---

表格语法（扩展语法）

使用3个以上连字符---创建每列的标题，并使用管道|分隔每列。CSDN中2个以上连字符--即可。

| 1 | 2 | 3 |
|---|---|---|
| a | b | c |

效果为

c1	c2	c3
a	b	c

表格中可以实现文本强调、代码以及超链接。不能解析标题，引用，列表，图像或HTML标签。

---

文本对齐

默认居中对齐，左对齐:--，居中:--:，右对齐--:。效果为

c1	c2	c3
a	b	c

---

图片语法

![图片无法正常显示时的显示文本](url "title")

例如，当图片的 url 无法正确解析时，效果为

title为鼠标悬停在图片上显示的文本，效果为

---

插入emoji表情（扩展语法）

更多emoji表情简码见GitHub 表情符号简码列表

:tent:
:+1:

效果为
⛺️
👍

---

图片超链接

实际就是嵌套了一层超链接

[![图片无法正常显示时的显示文本](url "title")](url "title")

---

公式语法（KaTeX）

CSDN中支持KaTeX内嵌公式，语法与LaTeX基本一致。

$公式$       // 行内插入
$$公式块$$   // 代码块

其余语法详见LaTeX。

效果为：$a+b=c$
$$\frac{x^3}{3}+1=2$$

---

1. foot ↩︎