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