剛來簡書不久泡态,簡書的默認編輯器是富文本編輯器,考慮到對于代碼塊不友好冲粤,我打算換成Markdown編輯器淫茵,在此記錄下Markdown的使用溃论。
Markdown簡介
Markdown 是一種純文本、輕量級的標記語言痘昌,通過簡單的標記語法,以純文本的形式編寫炬转,以HTML格式發(fā)布辆苔。由 Aaron Swartz 和 John Gruber 共同設計。
官方鏈接:
http://www.markdown.cn/
Markdown使用
目錄
標題
段落和換行
代碼區(qū)塊
區(qū)塊引用
列表
分割線
表格
字體
鏈接
代碼塊
圖片
強調
公式
腳注
自動郵箱鏈接
基本語法
標題
Markdown 支持兩種標題的語法扼劈,類 Setext 和類 atx 形式驻啤。這里指介紹類atx形式:
#這是h1
##這是h2
###這是h3
####這是h4
#####這是h5
######這是h6
效果如下:
這是h1
這是h2
這是h3
這是h4
這是h5
這是h6
段落和換行
段落:一個或多個連續(xù)的文本行,段落內會強迫換行(插入換行符)
空行:這一行包括一個以上的空行(空行定義:看起來是空的荐吵,比如骑冗,某一行包括一個空格和一個制表符,也是一個空行)
代碼區(qū)塊
在每行加上4個空格或者一個制表符(如同寫代碼一樣)
function a(){
}
注意:需要和普通段落之間存在空行先煎!
區(qū)塊引用
Markdown 標記區(qū)塊引用是使用類似 email 中用 (>) 的引用方式贼涩。
段落引用:
>這是個段落引用
>
>這是個段落引用
效果如下:
這是個段落引用
這是個段落引用
段落引用也可以只寫一個>
>This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
嵌套引用:
This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
效果如下:
This is nested blockquote.
Back to the first level.
嵌套引用中可以使用其他的語法:
> ## 這是一個標題。
>
> 1. 這是第一行列表項薯蝎。
> 2. 這是第二行列表項遥倦。
>
> 給出一些例子代碼:
>
> return shell_exec("echo $input | $markdown_script");
效果如下:
這是一個標題。
- 這是第一行列表項占锯。
- 這是第二行列表項袒哥。
給出一些例子代碼:
return shell_exec("echo $input | $markdown_script");
列表
Markdown 支持有序列表和無序列表缩筛。
無序列表使用星號、加號或是減號作為列表標記:
* Red
* Green
* Blue
- Red
- Green
- Blue
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
有序列表則使用數(shù)字接著一個英文句點:
1. Bird
2. McHale
3. Parish
- Bird
- McHale
- Parish
在列表第二個標記之后使用的數(shù)字并不會影響輸出的 HTML 結果堡称,即你的數(shù)字可以不按順序瞎抛,但是編輯器會自動根據(jù)第一個輸出:
3. Bird
1. McHale
3. Parish
- Bird
- McHale
- Parish
列表項目標記通常是放在最左邊,縮進最多 3 個空格却紧,項目標記后面則一定要接著至少一個空格或制表符桐臊。
列表項目可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或是 1 個制表符:
1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
-
This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
嵌套列表:在下一級輸入一定空格即可啄寡。
* Red
* Red
* Green
* Blue
* Green
* Blue
-
Red
- Red
- Green
- Blue
Green
Blue
分割線
在一行中用三個以上的星號豪硅、減號、底線來建立一個分隔線挺物,行內不能有其他東西懒浮。你也可以在星號或是減號中間插入空格
* * *
***
*****
- - -
---------------------------------------
表格
語法:
表頭|表頭|表頭
---|:--:|---:
內容|內容|內容
內容|內容|內容
表頭 | 表頭 | 表頭 |
---|---|---|
內容 | 內容 | 內容 |
內容 | 內容 | 內容 |
第二行分割表頭和內容。
- 有一個就行识藤,為了對齊砚著,多加了幾個
文字默認居左 - 兩邊加:表示文字居中
- 右邊加:表示文字居右
注:原生的語法兩邊都要用 | 包起來。此處省略
字體
**這是加粗的文字**
*這是傾斜的文字*`
***這是斜體加粗的文字***
~~這是加刪除線的文字~~
這是加粗的文字
這是傾斜的文字`
這是斜體加粗的文字
這是加刪除線的文字
鏈接
Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式痴昧。
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
This is an example inline link.
This link has no title attribute.
鏈接到主機:
See my [About](/about/) page for details.
See my About page for details.
參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號稽穆,而在第二個方括號里面要填入用以辨識鏈接的標記:
This is [an example][id] reference-style link.
This is an example reference-style link.
接著,在文件的任意處赶撰,你可以把這個標記的鏈接內容定義出來:
[id]: http://example.com/ "Optional Title Here"
鏈接辨別標簽可以有字母舌镶、數(shù)字、空白和標點符號豪娜,但是并不區(qū)分大小寫餐胀。
鏈接語法可以幫助我們實現(xiàn)在MarkDown文檔中寫目錄樹,MarkDown會自動給每一個h1~h6標題生成一個錨瘤载,其id就是標題內容否灾,目錄樹中的每一項都是一個跳轉鏈接,點擊后就會跳轉到其對應的錨點(即標題所在位置)鸣奔∧迹可以有兩種寫法:
- 使用Markdown的語法來增加跳轉鏈接:“名稱”。
- 使用HTML語法來增加跳轉鏈接:“<a href=”#id”>名稱
[使用Markdown語法增加的跳轉到“目錄”的鏈接](#目錄)
或者這么寫:
<a href="#目錄">使用HTML語法增加的跳轉到“目錄”的鏈接
效果:
<a href="#目錄">使用HTML語法增加的跳轉到“目錄”的鏈接
代碼塊
單行代碼:
`
單行代碼
`
單行代碼
代碼塊:點由一個變成三個“```”
代碼塊
圖片
語法
[圖片上傳失敗...(image-651641-1550589378470)]
圖片alt就是顯示在圖片下面的文字挎狸,相當于對圖片內容的解釋扣汪。
圖片title是圖片的標題,當鼠標移到圖片上時顯示的內容锨匆。title可加可不加
示例:
![程序貓](https://upload-images.jianshu.io/upload_images/15009210-
ca27889e0252066a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
強調
Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號私痹,被 * 或 _ 包圍的字詞會被轉成用 <em> 標簽包圍,用兩個 * 或 _ 包起來的話,則會被轉成 <strong>
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
single asterisks
single underscores
double asterisks
double underscores
如果要在文字前后直接插入普通的星號或底線紊遵,你可以用反斜線:
\*this text is surrounded by literal asterisks\*
*this text is surrounded by literal asterisks*
公式
$$ x \href{why-equal.html}{=} y^2 + 1 $$
$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $
腳注
Markdown[^1]
[^1]: Markdown是一種純文本標記語言 // 在文章最后面顯示腳注
Markdown[1]
自動郵箱鏈接
<xxx@outlook.com>
-
Markdown是一種純文本標記語言 // 在文章最后面顯示腳注 ?