Markdown 分级标题
1. 前言
关于 Markdown 的分级,官方给出了如下定义:
Markdown 提供了两种方式声明: Setext 和 Atx。Setext 风格的定义方式为在下方「等号 =
」或者 「减号 -
」。Atx 风格的定义方式为在前方 1~6 个「哈希符号 #
」,其对应 Html 中的 <h1>
~<h6>
。
原文出处:
通常都会有,是点明的最简单直接方式。
的分级是结构化的体现,它是长篇写作思路的高度概括,通过分级化的,可避免杂乱,使主线清晰。
环境说明:
考虑到 Markdown 工具之不兼容,有的直接从复制粘贴到本地不会正常,大家学习时自己动手写是肯定没问题的。本节所有实例及演示均使用 Typora 工具完成。
2. 语法详解
在 Markdown 中,一共存在两种定义方式。
定义方式是在下方,连续的三个 “等号”(===) 代表一级,连续的三个 “减号”(—)代表二级。
实例:
这是整篇的题目 === 这是章节题目---
将得到的如下:
定义方式是在行首连续的 “井号” (#) 及空格。1 个 “井号” 代表一级,2 个连续 “井号” 代表二级,以此类推,最多到 6 级。
实例:
# 这是## 这是### 这是#### 这是##### 这是###### 这是
渲染如下:
3. 场景及实例
是组织结构的最好方式。Markdown 的定义方式,不用担心格式混乱,始终保持结构性,作为创作者,只需要关心即可。在某些 Markdown 编写工具中,也可用于目录树或大纲。
实例:
本篇在 Typora 工具下大纲视图
4. 小结
使用 SeText 风格时,减号 (-) 或者 等号 (=) 必须连续三个以上才会出现。使用 Atx 风格时,井号 (#) 后面必须跟有空格,否则也不会出现。
Markdown 渲染的最终结果会因不同的渲染引擎产生不同的,例如:
Github 风格
Newsprit 风格
我们在编写文档之前,应构思好整个的脉络、结构,再去动笔不断细化。善用定义帮我们理清思路,利用其大纲不断检视是否过于发散,逻辑是否清晰合理。