Markdown 分級標(biāo)題
1. 前言
關(guān)于 Markdown 的分級標(biāo)題,官方給出了如下定義:
Markdown 提供了兩種方式聲明標(biāo)題: Setext 和 Atx。Setext 風(fēng)格的標(biāo)題定義方式為在標(biāo)題文字下方增加「等號
=
」或者 「減號-
」。Atx 風(fēng)格的標(biāo)題定義方式為在標(biāo)題文字前方增加 1~6 個「哈希符號#
」,其對應(yīng) Html 中的<h1>
~<h6>
。原文出處:daringfireball.net
文章通常都會有標(biāo)題,標(biāo)題是點(diǎn)明文章主題的最簡單直接方式。
標(biāo)題的分級是文章結(jié)構(gòu)化的體現(xiàn),它是長篇文章寫作思路的高度概括,通過分級化的標(biāo)題,可避免文章雜亂,使文章主線清晰。
環(huán)境說明:
考慮到 Markdown 工具之間的不兼容,有的內(nèi)容直接從頁面復(fù)制粘貼到本地不會正常顯示,大家學(xué)習(xí)時自己動手寫是肯定沒問題的。本節(jié)所有實例代碼及演示效果均使用 Typora 工具完成。
2. 語法詳解
在 Markdown 文件中,一共存在兩種標(biāo)題定義方式。
2.1 SeText 風(fēng)格
定義方式是在標(biāo)題文字下方添加標(biāo)記,連續(xù)的三個 “等號”(===) 代表一級標(biāo)題,連續(xù)的三個 “減號”(—)代表二級標(biāo)題。
實例:
這是整篇文章的題目
===
這是一個章節(jié)題目
---
將得到的效果如下:
2.2 Atx 風(fēng)格
定義方式是在標(biāo)題文字行首增加連續(xù)的 “井號” (#) 及空格。1 個 “井號” 代表一級標(biāo)題,2 個連續(xù) “井號” 代表二級標(biāo)題,以此類推,最多支持到 6 級標(biāo)題。
實例:
# 這是一個標(biāo)題
## 這是一個標(biāo)題
### 這是一個標(biāo)題
#### 這是一個標(biāo)題
##### 這是一個標(biāo)題
###### 這是一個標(biāo)題
渲染效果如下:
3. 場景及實例
標(biāo)題是組織文章結(jié)構(gòu)的最好方式。Markdown 的標(biāo)題定義方式,不用擔(dān)心標(biāo)題格式混亂,文章始終保持結(jié)構(gòu)性,作為創(chuàng)作者,只需要關(guān)心內(nèi)容即可。在某些 Markdown 編寫工具中,標(biāo)題也可用于自動生成目錄樹或大綱。
實例:
本篇文章在 Typora 工具下生成大綱視圖
4. 小結(jié)
-
使用 SeText 風(fēng)格時,減號 (-) 或者 等號 (=) 必須連續(xù)三個以上才會出現(xiàn)標(biāo)題效果。使用 Atx 風(fēng)格時,井號 (#) 后面必須跟有空格,否則也不會出現(xiàn)標(biāo)題效果。
-
Markdown 標(biāo)題渲染的最終結(jié)果會因不同的渲染引擎產(chǎn)生不同的效果,例如:
Github 風(fēng)格
Newsprit 風(fēng)格
我們在編寫文檔之前,應(yīng)構(gòu)思好整個文章的脈絡(luò)、結(jié)構(gòu),再去動筆不斷細(xì)化。善用標(biāo)題定義幫我們理清思路,利用其大綱功能不斷檢視文章內(nèi)容是否過于發(fā)散,邏輯是否清晰合理。