The usage of Markdown---标题

Posted 2022-10-29 liangjianli

更新时间：2019.09.14

目录：
1. 序言
2. 标题
??2.1 类Atx形式
??2.2 类Setext形式
3. 总结

1. 序言

??Markdown是一种纯文本的标记语言，只要熟悉Markdown的语法，就能写出简洁明了的文章，也再不用调格式调到心累了。另外，现在有许多编辑器都支持markdown的编写，能够跨平台使用，并且兼容html语法。
??但是有个巨坑就是，Markdown语法并没有统一的标准。对于不同的编辑器，所用的Markdown语法可能略有差异(有时这点差异也是够折腾的)。
??由于我经常使用jupyter notebook，并且有时写一下博客，都需要使用markdown来编写。因此，分几个篇章总结一下Markdown的语法(主要是针对jupyter notebook和博客园的)。

• ps：放在一起实在太过臃肿，因此选择分开呈现(而且也方便查看)。

2. 标题

2.1 类Atx形式

??我们通常多个数量的#来表示多级标题(类Atx的形式)，并且最多能够表示6级标题。

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

• tip1：在jupyter notebook的命令行模式（按ESC）中，可以通过按1~6来将代码块切换到标题1~6级
• tip2: 在显示上jupyter notebook的四五六级标题并没有明显的差别，并且table of contents最多显示到四级标题
• tip3：博客园的五六级标题并没有太大的差别

---

以下是博客园的显示效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

---

以下是jupyter notebook的显示效果：

---

2.2 类Setext形式

??除此之外，还有一种不常用的语法(类Setext的形式)来表示一二级标题(在jupyter notebook中要使用两个符号以上)

• 使用任意数量的等号=来表示一级标题
• 使用任意数量的连号符-来表示二级标题

一级标题
=

一级标题
==

二级标题
------

以下是博客园的显示效果：

一级标题

一级标题

二级标题

---

以下是jupyter notebook的代码和显示效果：

---

ps：反正如果用这种表示方法，=和-就按多几个，最好就不用这种方法。

3. 总结

??经过上面几个例子的比较就知道不同的Markdown的编辑器多多少少都有点不同，我们只要从大体上掌握Markdown的语法，并熟悉几款常用的Markdown编辑器就可以了。
??对于标题，就直接用类Atx形式就好了，这也是最常用的。而类Setext形式的标题只要了解一下就好了。