Markdown学习之路 - 分级标题

本章节学习内容来自慕课教程
学习采用的Markdown编辑器为Typora

1. 前言

关于 Markdown 的分级标题,官方给出了如下定义:

Markdown 提供了两种方式声明标题: setext 和 atx。setext 风格的标题定义方式为在标题文字下方增加 = 或者 - 。atx 风格的标题定义方式为在标题文字前方增加 1~6 个哈希符号 # ,其对应 Html 中的 <h1>~<h6>。原文出处:daringfireball.net

2. 语法

2.1 setext风格

定义方式是在文字下方添加标记,连续的3个 === 代表一级标题,连续三个 - 代表二级标题。

了解此种语法即可,我平时都用atx语法,即 # 的写法

2.2 atx风格

实例:

# 一级标题对应h1标签
## 二级标题对应h2标签
### 三级标题对应h3标签
#### 四级标题对应h4标签
##### 五级标题对应h5标签
###### 六级标题对应h6标签

渲染效果:

分级标题渲染示例图

3. 使用场景

  • 可用于自动生成目录树或大纲。
  • 保持文章结构清晰。

生成的大纲实例:

生成的大纲效果图

4. 小结

  • 使用 setext风格时,- 或者 等号 = 必须连续三个以上才会出现标题效果。使用 atx 风格时,# 后面必须跟有空格,否则也不会出现标题效果。
  • Markdown 标题渲染的最终结果会因不同的渲染引擎产生不同的效果

github 风格

GitHub风格

newscript风格

Newscript风格