更新时间: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形式的标题只要了解一下就好了。