您好, 欢迎来到 !    登录 | 注册 | | 设为首页 | 收藏本站

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 风格

我们在编写文档之前,应构思好整个的脉络、结构,再去动笔不断细化。善用定义帮我们理清思路,利用其大纲不断检视是否过于发散,逻辑是否清晰合理。


联系我
置顶