亚洲在线久爱草,狠狠天天香蕉网,天天搞日日干久草,伊人亚洲日本欧美

Markdown 分級標題

1. 前言

關于 Markdown 的分級標題,官方給出了如下定義:

Markdown 提供了兩種方式聲明標題: Setext 和 Atx。Setext 風格的標題定義方式為在標題文字下方增加「等號 =」或者 「減號 -」。Atx 風格的標題定義方式為在標題文字前方增加 1~6 個「哈希符號 #」,其對應 Html 中的 <h1>~<h6>

原文出處daringfireball.net

文章通常都會有標題,標題是點明文章主題的最簡單直接方式。
標題的分級是文章結構化的體現,它是長篇文章寫作思路的高度概括,通過分級化的標題,可避免文章雜亂,使文章主線清晰。

環境說明
考慮到 Markdown 工具之間的不兼容,有的內容直接從頁面復制粘貼到本地不會正常顯示,大家學習時自己動手寫是肯定沒問題的。本節所有實例代碼及演示效果均使用 Typora 工具完成。

2. 語法詳解

在 Markdown 文件中,一共存在兩種標題定義方式。

2.1 SeText 風格

定義方式是在標題文字下方添加標記,連續的三個 “等號”(===) 代表一級標題,連續的三個 “減號”(—)代表二級標題。

實例

這是整篇文章的題目
===

這是一個章節題目
---

將得到的效果如下:

圖片描述

2.2 Atx 風格

定義方式是在標題文字行首增加連續的 “井號” (#) 及空格。1 個 “井號” 代表一級標題,2 個連續 “井號” 代表二級標題,以此類推,最多支持到 6 級標題。

實例

# 這是一個標題
## 這是一個標題
### 這是一個標題
#### 這是一個標題
##### 這是一個標題
###### 這是一個標題

渲染效果如下:

圖片描述

3. 場景及實例

標題是組織文章結構的最好方式。Markdown 的標題定義方式,不用擔心標題格式混亂,文章始終保持結構性,作為創作者,只需要關心內容即可。在某些 Markdown 編寫工具中,標題也可用于自動生成目錄樹或大綱。

實例
本篇文章在 Typora 工具下生成大綱視圖
圖片描述

4. 小結

  1. 使用 SeText 風格時,減號 (-) 或者 等號 (=) 必須連續三個以上才會出現標題效果。使用 Atx 風格時,井號 (#) 后面必須跟有空格,否則也不會出現標題效果。

  2. Markdown 標題渲染的最終結果會因不同的渲染引擎產生不同的效果,例如:

Github 風格

圖片描述

Newsprit 風格

圖片描述

我們在編寫文檔之前,應構思好整個文章的脈絡、結構,再去動筆不斷細化。善用標題定義幫我們理清思路,利用其大綱功能不斷檢視文章內容是否過于發散,邏輯是否清晰合理。