Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔。
Markdown 語言在 2004 由約翰·格魯伯(英語:John Gruber)創建。
Markdown 編寫的文檔可以導出 HTML 、Word、圖像、PDF、Epub 等多種格式的文檔。
Markdown 編寫的文檔后綴為 .md, .markdown。
Markdown 標題
Markdown 標題有兩種格式。
(1)使用 = 和 - 標記一級和二級標題
= 和 - 標記語法格式如下:
我展示的是一級標題
我展示的是二級標題
(2)使用 # 號標記
使用 # 號可表示 1-6 級標題,一級標題對應一個 # 號,二級標題對應兩個 # 號,以此類推。
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
Markdown 段落
Markdown 段落沒有特殊的格式,直接編寫文字就好,段落的換行是使用兩個以上空格加上回車。
當然也可以在段落后面使用一個空行來表示重新開始一個段落。
字體
Markdown 可以使用以下幾種字體:
斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本
分隔線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
刪除線
如果段落上的文字要添加刪除線,只需要在文字的兩端加上兩個波浪線 ~~ 即可,實例如下:
RUNOOB.COM
GOOGLE.COM
BAIDU.COM
下劃線
下劃線可以通過 HTML 的 <u> 標簽來實現:
<u>帶下劃線文本</u>
腳注
腳注是對文本的補充說明。
Markdown 腳注的格式如下:
[^要注明的文本]
以下實例演示了腳注的用法:
創建腳注格式類似這樣 [1]。
Markdown 列表
Markdown 支持有序列表和無序列表。
無序列表使用星號(*)、加號(+)或是減號(-)作為列表標記,這些標記后面要添加一個空格,然后再填寫內容:
- 第一項
- 第二項
- 第三項
- 第一項
- 第二項
- 第三項
- 第一項
- 第二項
- 第三項
有序列表使用數字并加上 . 號來表示,如:
- 第一項
- 第二項
- 第三項
列表嵌套
列表嵌套只需在子列表中的選項前面添加四個空格即可:
- 第一項:
- 第一項嵌套的第一個元素
- 第一項嵌套的第二個元素
- 第二項:
- 第二項嵌套的第一個元素
- 第二項嵌套的第二個元素
Markdown 區塊
Markdown 區塊引用是在段落開頭使用 > 符號 ,然后后面緊跟一個空格符號:
區塊引用
菜鳥教程
學的不僅是技術更是夢想
另外區塊是可以嵌套的,一個 > 符號是最外層,兩個 > 符號是第一層嵌套,以此類推:
最外層
第一層嵌套
第二層嵌套
區塊中使用列表
區塊中使用列表實例如下:
區塊中使用列表
- 第一項
- 第二項
- 第一項
- 第二項
- 第三項
列表中使用區塊
如果要在列表項目內放進區塊,那么就需要在 > 前添加四個空格的縮進。
列表中使用區塊實例如下:
- 第一項
菜鳥教程
學的不僅是技術更是夢想 - 第二項
Markdown 代碼
如果是段落上的一個函數或片段的代碼可以用反引號把它包起來(`),例如:
printf()
函數
代碼區塊
代碼區塊使用 4 個空格或者一個制表符(Tab 鍵)。
實例如下:
顯示結果如下:
你也可以用 ``` 包裹一段代碼,并指定一種語言(也可以不指定):
$(document).ready(function () {
alert('RUNOOB');
});
Markdown 鏈接
鏈接使用方法如下:
或者
<鏈接地址>
例如:這是一個鏈接 菜鳥教程
直接使用鏈接地址:https://www.runoob.com
高級鏈接
我們可以通過變量來設置一個鏈接,變量賦值在文檔末尾進行:
這個鏈接用 1 作為網址變量 Google
這個鏈接用 runoob 作為網址變量 Runoob
然后在文檔的結尾為變量賦值(網址)
Markdown 圖片
Markdown 圖片語法格式如下:
開頭一個感嘆號 !
接著一個方括號,里面放上圖片的替代文字
接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上選擇性的 'title' 屬性的文字。
當然,你也可以像網址那樣對圖片網址使用變量:
這個鏈接用 1 作為網址變量 RUNOOB.
然后在文檔的結尾為變量賦值(網址)
Markdown 還沒有辦法指定圖片的高度與寬度,如果你需要的話,你可以使用普通的 <img> 標簽。
<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">
Markdown 表格
Markdown 制作表格使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行。
語法格式如下:
表頭 | 表頭 |
---|---|
單元格 | 單元格 |
單元格 | 單元格 |
對齊方式
我們可以設置表格的對齊方式:
-: 設置內容和標題欄居右對齊。
:- 設置內容和標題欄居左對齊。
:-: 設置內容和標題欄居中對齊。
實例如下:
左對齊 | 右對齊 | 居中對齊 |
---|---|---|
單元格 | 單元格 | 單元格 |
單元格 | 單元格 | 單元格 |
Markdown 高級技巧
支持的 HTML 元素
不在 Markdown 涵蓋范圍之內的標簽,都可以直接在文檔里面用 HTML 撰寫。
目前支持的 HTML 元素有:<kbd> <b> <i> <em>
等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦
轉義
Markdown 使用了很多特殊符號來表示特定的意義,如果需要顯示特定的符號則需要使用轉義字符,Markdown 使用反斜杠轉義特殊字符:
文本加粗
** 正常顯示星號 **
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
公式
當你需要在編輯器中插入數學公式時,可以使用兩個美元符 $$ 包裹 TeX 或 LaTeX 格式的數學公式來實現。提交后,問答和文章頁會根據需要加載 Mathjax 對數學公式進行渲染。如:
-
菜鳥教程 -- 學的不僅是技術,更是夢想!!! ?