The usage of Markdown---标题

更新时间: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的显示效果:
jupyter notebook的标题显示(类Atx)



2.2 类Setext形式

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

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

一级标题
==

二级标题
------

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

一级标题

一级标题

二级标题


以下是jupyter notebook的代码和显示效果:
jupyter notebook的标题显示(类Setext)


ps:反正如果用这种表示方法,=-就按多几个,最好就不用这种方法眯眯眼表情

3. 总结

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

猜你喜欢

转载自www.cnblogs.com/liangjianli/p/11518043.html