markdown语法

Black大约 6 分钟

标题

根据#（最右侧#后至少加一个空格）的数量设置1-6级标题。

由于不同软件对标题的修饰不同，因此可能效果会有所不同。

原文	演示效果
`# 一级标题`	一级标题
`# 二级标题`	一级标题
`# 三级标题`	一级标题
`# 四级标题`	一级标题
`# 五级标题`	一级标题
`# 六级标题`	一级标题

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

提示

一个文件通常只在文章开头设置一个一级标题。

正文

正文换行应增加一个空行，不加空行会挨得比较紧凑。

第一行。

第二行。

第三行。

连续一行。
连续二行。
连续三行。

普通第一行。

普通第二行。

普通第三行。

连续一行。
连续二行。
连续三行。

分隔线

为了保持最好的兼容性，分隔线前后都应该加一个换行。

---

***

___

字体

斜体：文字两端各一个*或_，*斜体*、_斜体_。

加粗：文字两端各两个*，**斜体**。

加粗斜体：文字两端各三个*，***斜体***。

~~删除线~~：文字两端两个~，~~删除线~~。

有时候为了设置颜色等格式，可以使用内联html代码块。

这是一个字体。

这是一个<font color=red>红色</font>字体。

代码

代码块

使用三个`加语言类型实现并以三个`结束，部分语言可以使用缩写。

```js

console.log("hello world!");

```

console.log("hello world!");

行内代码

两端各使用一个`包围内容实现行内代码。部分编辑器中第二个`输入后需要按一下空格。

比如这里的x + y 。

比如这里的`x + y` 。

表格

A	B	C	D
A1	B1	C1	D1
A2	B2	C2	D2

|A|B|C|D|
|-|-|-|-|
|A1|B1|C1|D1|
|A2|B2|C2|D2|

第二行至少有一个-即可。如果需要对齐，可以在第二行使用: 对齐。

A	B	C	D
左对齐	居中	右对齐	默认对齐
A2	B2	C2	D2

|A|B|C|D|
|:----|:-:|--:|-------|
|左对齐|居中|右对齐|默认对齐|
|A2|B2|C2|D2|

如果需要合并单元格等操作，markdown原生语法并不支持（部分软件支持快捷操作），可以使用内联HTML代码实现表格。

列表

无序列表

使用-、*、+前面跟若干（0个或更多个）水平制表符（tab键）。

一级1
- 二级1
  - 三级1
  - 三级2
  - 三级3
    - 四级

一级2

一级3

- 一级1
    - 二级1
      - 三级1
      * 三级2
      * 三级3
        * 四级
+ 一级2
* 一级3

有序列表

数字加小数点（再补个空格）生成序列。

1
1. 1.1
  1. 1.1.1
  2. 1.1.2
2
3

1. 1
   1. 1.1
      1. 1.1.1
      2. 1.1.2
2. 2
3. 3

链接

这是一个首页链接。

这是一个[首页链接](/)。

这是一个[首页链接](/ "悬停提示")。

直接链接

https://www.baidu.com/

1.zhangkun@163.com

<https://www.baidu.com/>

<1.zhangkun@163.com>

也可以添加样式

这是一个 首页链接。

这是一个 首页链接。

这是一个首页链接。

这是一个 **[首页链接](/)**。

这是一个 *[首页链接](/)*。

这是一个[`首页链接`](/)。

引用

引用1
引用2
列表1
列表2
嵌套引用1
嵌套引用2
引用3

> 引用1
> 引用2
> - 列表1
> - 列表2
>> 嵌套引用1
> > 嵌套引用2
> 
> 引用3

图片

普通图片

![示例图片](/logo128.png)

base64图片

BASE64图片使用data:image/png;base64,加图片的base64字符串。

![BASE64图片](data:image/png;base64,iVBORw0KGgoA...kJggg==)

带链接的图片

不同版本提示效果可能不同。

[![示例图片](/logo128.png "可选提示")](/)

字符转义

普通情况

通常只需要使用\对字符进行转义。

通常只需要使用\对~~字符~~进行转义。

通常只需要使用`\`对~~字符~~进行转义。

通常只需要使用`\`对\~\~字符\~\~进行转义。

特殊实体

部分特殊的字符可能需要额外处理，在html文件中<和&有特殊含义，因此可能需要使用实体形式<和&。

内嵌html

行级内联标签

markdown原生支持html，比如斜体，加粗。

markdown原生支持html，比如<em>斜体</em>，<strong>加粗</strong>。

区块标签

1行标题1	1行标题2	1行标题3
2行标题1	2行标题2	2行标题3
1	2	3
3	4	5

<table>
  <thead>
    <tr>
      <th>1行标题1</th><th>1行标题2</th><th>1行标题3</th>
    </tr>
    <tr>
      <th>2行标题1</th><th>2行标题2</th><th>2行标题3</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>1</td><td>2</td><td>3</td>
    </tr>
    <tr>
      <td>3</td><td>4</td><td>5</td>
    </tr>
  </tbody>
</table>

注：表格最好按照table>thead+tbody的形式，不然可能不兼容。

拓展语法

拓展语法并非所有的编辑器都支持。

任务列表

- [x] a
- [ ] b
- [x] c

emoji

你可以使用简写形式引用emoji，形式为:简写:。

这个一个emojy表情😂。

这个一个emojy表情:joy:。

更多简写参见Complete list of github markdown emoji markup。

脚注

不同软件对其支持不同，效果也不同。由于脚注会始终出现在文章尾部，此处不再演示。

Excel[^1]和WPS[^WPS]都是不错的办公软件[^4]。

[^1]:Excel，脚注1。
[^WPS]:WPS，脚注2。
[^4]: 办公软件，脚注3。

Latex公式

行内公式

使用$加在latex语句两端。

圆的面积公式为 $π r^{2}$ 。

圆的面积公式为$\pi r^2$。

公式块

使用$$加在公式块两端，且需要换行。

\begin{aligned} A & = \sum_{i = 1}^{n} x^{i} \\ B C D & = \frac{A}{2} \end{aligned}

$$ 
\begin{align*}
A &= \sum_{i=1}^{n}x^i \\
BCD &= \frac{A}{2} \\
\end{align*}
$$