Markdown学习之路 - 分级标题
Markdown学习之路 - 分级标题
1. 前言
关于 Markdown 的分级标题,官方给出了如下定义:
Markdown 提供了两种方式声明标题: setext 和 atx。setext 风格的标题定义方式为在标题文字下方增加
=
或者-
。atx 风格的标题定义方式为在标题文字前方增加 1~6 个哈希符号#
,其对应 Html 中的 <h1>~<h6>。原文出处:daringfireball.net
2. 语法
2.1 setext风格
定义方式是在文字下方添加标记,连续的3个 ===
代表一级标题,连续三个 -
代表二级标题。
了解此种语法即可,我平时都用atx语法,即
#
的写法
2.2 atx风格
实例:
# 一级标题对应h1标签 |
渲染效果:
3. 使用场景
- 可用于自动生成目录树或大纲。
- 保持文章结构清晰。
生成的大纲实例:
4. 小结
- 使用 setext风格时,
-
或者 等号=
必须连续三个以上才会出现标题效果。使用 atx 风格时,#
后面必须跟有空格,否则也不会出现标题效果。 - Markdown 标题渲染的最终结果会因不同的渲染引擎产生不同的效果
github 风格
newscript风格
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 DecoderX!
评论