Markdown作為一種使用普通文本編輯器編寫的標記語言,通過簡單的標記語法诡壁,設置文本不同的格式济瓢。以實現(xiàn) [易讀易寫] 的目標。
Markdown為編寫HTML提供了很好的實現(xiàn)妹卿,并避免了伴隨的復雜性和丑陋難看旺矾。Markdown的語法全由一些符號組成,語法簡單易上手夺克。
本文介紹Markdown語法入門箕宙。
一、語法介紹
1.1 標題
1.1.1 Setext形式
類Setext形式是用底線的形式铺纽,利用 =
(最高階標題) 和 -
(第二階標題)柬帕,例如:
This is H1
===========
This is H2
-------------------
This is H1
This is H2
注意:其中,任何數(shù)量的 =
和 -
都是等效的狡门。
1.1.2 Atx形式
類Atx形式是在行首插入 1 到 6個 #
陷寝,對應分別為標題 1
到 6
階,例如:
# H1 #
## H2 ##
### H3 ###
#### H4 ####
##### H5 #####
##### H6 #####
H1
H2
H3
H4
H5
H6
通常其馏,若為了美觀用凤跑,可以在行尾加上 #
,行尾的 #
不強制要求和開頭一樣叛复,只有行首的字符數(shù)確定標題對應的階數(shù)仔引。
1.2 區(qū)塊引用Blockquotes
Markdown 標記區(qū)塊引用類似email中用 >
的引用方式。在每行的前面加上 >
褐奥。
同樣咖耘,Markdown允許只在整個段落的第一行最前加上 >
。
區(qū)塊引用也可以嵌套撬码,根據(jù)不同層次加上不同數(shù)量的 >
即可儿倒。
引用的區(qū)塊內同樣可以使用其他Markdown 語法,包括標題耍群,列表义桂,代碼區(qū)塊等
找筝。
> 區(qū)塊引用...
>
> 區(qū)塊引用...
> 段落只需要要在第一行加上
整個段落即引用在區(qū)塊內蹈垢。
> 區(qū)塊間引用
>> 區(qū)塊間引用
> ### 引用其他語法
區(qū)塊引用...
區(qū)塊引用...
段落只需要要在第一行加上
整個段落即引用在區(qū)塊內。
區(qū)塊間引用
區(qū)塊間引用
引用其他語法
1.3 列表
Markdown支持有序列表和無序列表袖裕。
1.3.1 有序列表
有序列表使用1.
數(shù)字接著一個英文句點曹抬;特別注意的是在標記上使用的數(shù)字并不會影響輸出結果;列表項還可以包含多個段落急鳄,每個列表下段落都必須縮進4個空格或者1個制表符谤民;如果需要在列表項目內引用的時候堰酿,使用 >
需要縮進。例如如下語法:
1. item 1
3. item 2(標記上使用的數(shù)字并不會影響輸出結果)
2. item 3(標記上使用的數(shù)字并不會影響輸出結果)
4. item 4
多段文字1
多段文字1
>區(qū)塊引用
5. item 5
1.列表項目內加列表
- item 1
- item 2(標記上使用的數(shù)字并不會影響輸出結果)
- item 3(標記上使用的數(shù)字并不會影響輸出結果)
- item 4
多段文字1
多段文字1區(qū)塊引用
- item 5
1.列表項目內加列表
1.3.2 無序列表
無序列表使用 *
(星號)张足、+
(加好) 以及 -
(減號)作為列表標記:
- item 1
+ item 2
* item 3
- item 3.1
- item 3.1.1
- item 1
- item 2
- item 3
- item 3.1
- item 3.1.1
- item 3.1
1.4 代碼區(qū)塊
和程序相關的寫作通常會用到代碼區(qū)塊触创,如果用區(qū)塊引用排版就會和代碼排版有差異,而我們更希望是按照原來的樣子顯示为牍。Markdown 通過 <code>`</code> 和 <code>```</code> 標簽來把代碼區(qū)塊包起來哼绑。
在代碼區(qū)塊里, &
碉咆、<
和>
會自動轉換成HTML試題抖韩,這樣讓諸如插入范例使用的HTML原始碼更方便了。
<div class="footer">
? 2004 Foo Corporation
</div>
在代碼區(qū)塊中疫铜,一般的Markdown語法不會被轉換茂浮,因此可以很容易的用Markdown語法撰寫相關語法文檔。
1.5 分割線
在任意一行中用三個以上的 *
壳咕、-
以及_
來建立分割線席揽,行內不能有除空格
外的其他內容。
1.6 特殊格式
1.6.1 粗體
粗體文字設置使用 **
將目標文字包含起來谓厘。
Bold
1.6.2 斜體
斜體文字設置使用 _
將目標文字包含起來驹尼。
Italics
1.6.3 刪除線
斜體文字設置使用 ~~
將目標文字包含起來。
strikethrough
1.6.4 語法高亮
特定語法用如<code>```js</code>將設置超鏈接的文字包含起來庞呕。
grunt.initConfig({
assemble: {
options: {
assets: 'docs/assets',
data: 'src/data/*.{json,yml}',
helpers: 'src/custom-helpers.js',
partials: ['src/partials/**/*.{hbs,md}']
},
pages: {
options: {
layout: 'default.hbs'
},
files: {
'./': ['src/templates/pages/index.hbs']
}
}
}
};
1.7 表格
1.7.1 普通表格
表格通過 |
和 -
表示新翎。表頭需要和表內容用 -
分割,各列內容用 |
分割住练。注意地啰,不需要垂直對齊。
|table1|table2|
|--------|-------|
|content1|content2|
table1 | table2 |
---|---|
content1 | content2 |
1.7.1 特殊格式表格
在表頭內容分割線結束加上 :
即表示文字靠右對齊讲逛。
|table1|table2|
|--------:|-------:|
|content1|content2|
table1 | table2 |
---|---|
content1 | content2 |
1.8 超鏈接
超鏈接通過 [ 超鏈接文字 ]
包含超鏈接文字內容亏吝,并在后緊跟 (URL)
超鏈接地址。
[Link](http://www.reibang.com/u/7f8d85055cd1)
當需要為超鏈接添加hover效果的時候盏混,在 (URL "hoverTitle")
URL后用 ""
將提示文字包含起來蔚鸥。
[Link](http://www.reibang.com/u/7f8d85055cd1 "Burjal")
1.9 Named Anchors
Named Anchors使能夠在相同的頁面上跳轉到指定的錨點。最常用的就是跳轉到每一個章節(jié)许赃。
# Table of Contents
* [Chapter 1](#chapter-1)
* [Chapter 2](#chapter-2)
* [Chapter 3](#chapter-3)
Table of Contents
上述會跳轉到對應如下位置:
## Chapter 1 <a id="chapter-1"></a>
Content for chapter one.
## Chapter 2 <a id="chapter-2"></a>
Content for chapter one.
## Chapter 3 <a id="chapter-3"></a>
Content for chapter one.
1.20 圖片
圖片的語法和超鏈接的語法類似止喷,在超鏈接語法前加了 !
。
![Markdown](http://upload-images.jianshu.io/upload_images/311578-26c2869134c4e359.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
二混聊、簡書設置默認編輯器:
簡書已經支持Markdown語法編輯弹谁。
設置步驟如下:
在首頁找到并進入設置。
將常用編輯器設置為 Markdown
。
Markdown 語法入門分析到此就結束了~
附: