markdown用法總結
markdown用法詳解
Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。最近在使用markdown整理筆記的時候,簡直對它愛不釋手,因此來整理一下markdown 的基本使用方式,簡直是程式員寫作的一大神器,強烈推薦上手學習。本次分享的內容主要有以下四點。
[TOC]
markdown的由來
markdown的創作者是亞倫·斯沃茨(Aaron Swartz),他發明了這種簡單易用的富文字標記語言。
這個語言的目的是希望大家使用“易於閱讀、易於撰寫的純文字格式,並選擇性的轉換成 有效的XHTML(或是 HTML)”。幫助我們實現易讀易寫的功能,快速上手使用。
markdown常用的編輯器推薦
1.馬克飛象
由於印象筆記Windows客戶端暫不支援markdown文字編輯,所以許多使用印象筆記的程式猿就很蛋疼。好在馬克飛象幫我們解決了這個問題,它可以幫我們將文字同步到印象筆記中(注意這不是打廣告),我最近也一直在使用馬克飛象進行筆記總結。有多個主題和詳細的使用文件可以檢視,使用者體驗還不錯。
2.小書匠
一款全平臺覆蓋的markdown文字編輯器,並且有線上web版,功能很強大。對於不願折騰的人來說,使用很方便,開啟瀏覽器就可以輕鬆使用。
3. 簡書
簡書很早就開始支援markdown語法,並且強烈推薦使用,我們直接可以在簡書編輯好釋出我們的文章,一氣呵成。
4. 掘金
一個開發者技術交流平臺,支援markdown語法進行創作。
5.MarkdownPad
MarkdownPad 一款全功能的編輯器,被很多人稱讚為windows 平臺最好用的markdown編輯器。但是介面是英文,怕很多使用者不喜歡。
markdown的基本用法
說了這麼早,終於到正題了。下面開始介紹markdown的基本用法,保證你看完之後很快上手。
1.標題
在需要設定標題的文字前面加#來形成標題。在#結束的時候新增空格和標題 分開,最多支援六級標題。下面是例項。
// 示例 # 一級標題 ## 二級標題 ### 三級標題 #### 四級標題 ##### 五級標題 ###### 六級標題
2.字型
字型的用法主要有斜體,加粗,斜體加粗,加刪除線
-
加粗
前後兩個*將文字包裹起來
這是加粗的文字
//示例 **這是加粗的文字**
-
斜體
前後一個*將文字包裹起來
這是斜體文字
//示例 *這是加粗的文字*
- 斜體加粗
- 前後三個*將文字包裹起來
斜體加粗
//示例 ***這是加粗的文字***
-
刪除線
新增刪除線
//示例 ~~這是加粗的文字~~
3.引用
在引用的文字前加>即可。引用也可以巢狀,如加兩個>>三個>>>,可以一直巢狀下去,只需要繼續新增>即可
- 不加巢狀的引用
引用1
引用2
引用3
// 示例 >引用1 >引用2 >引用3
- 新增巢狀的引用
引用1
引用2
引用3
// 示例 >引用1 >>引用2 >>> 引用3
4.為上下文新增分割線
需要注意的是至少需要三個同樣的符號以上。
// 以下幾種都可以 --- ---- *** *****
5.圖片

image
 圖片標題就是顯示在圖片下面的文字,相當於對圖片內容的解釋,也可以不加。 圖片描述,當滑鼠移到圖片上時顯示的內容。title可加可不加,不是所有的編輯器都支援 // 示例 
6.超連結
行內連結 馬克飛象
// 示例 [百度](http://baidu.com) 行內連結[馬克飛象](https://maxiang.io/)
7.程式碼
markdown語法很好的支援嵌入程式碼和程式碼塊,極大方便了程式設計師寫作和記筆記
這是 單行程式碼
//示例 這是`單行程式碼`
這是程式碼塊
bezierAnimator.setDuration(10000); bezierAnimator.addUpdateListener(newValueAnimator.AnimatorUpdateListener() { @Override public void onAnimationUpdate(ValueAnimator valueAnimator) { PointF pointF = (PointF) valueAnimator.getAnimatedValue(); // 不斷改變檢視的位置 iv.setX(pointF.x); iv.setY(pointF.y); } });
// 示例 這是`單行程式碼` 用一對``包裹 這是程式碼塊 用三個```程式碼塊```包裹
8.列表
-
無序列表
無序列表用 - + * 任何一種都可以,注意文字前加空格
-
列表1
-
列表2
-
列表3
// 示例 - 列表1 - 列表2 - 列表3
-
有序列表
數字加點,注意文字前加空格
- 列表1
- 列表2
- 列表3
// 示例 1. 列表1 2. 列表2 3. 列表3
-
組合使用
子列表每行縮排3個以上空格
-
列表1
1. 列表1
2. 列表2
3. 列表3
// 示例
- 列表1
- 列表1
- 列表2
- 列表3
##### 9.表格 表頭|表頭|表頭 :---|:--:|---: 左對齊|居中|右對齊 內容|內容|內容 第二行分割表頭和內容。 \- 有一個就行,為了對齊美觀 文字預設居左 -兩邊加:表示文字居中 -右邊加:表示文字居右
// 示例
表頭 | 表頭 | 表頭 |
---|---|---|
內容 | 內容 | 內容 |
內容 | 內容 | 內容 |
##### 10.反斜槓 用\來實現轉義字元的效果 \\ \! \{}
// 示例
\ 反斜線
` 反引號
* 星號
_ 底線
{ 左花括號
} 右花括號
[ 左方括號
] 右方括號
##### 11.自動生成目錄 使用\[TOC]來生成,可能有些編輯器不能支援,馬克飛象可以支援。 [TOC]
// 示例
[TOC]
##### 12.自動連結 自動連結只要是用尖括號包起來,就會自動被轉成連結。一般網址的連結文字就和連結地址一樣。 <http://baidu.com>
// 示例
http://baidu.com**基本的markdown語法就介紹到這裡,相信已經可以滿足98%的寫作需求,至於新增流程圖和插入公式的不常用的用法就不介紹了,百度一下可以知道。** #### markdown相關文件推薦 <http://www.appinn.com/markdown/> <https://www.jianshu.com/p/191d1e21f7ed> <https://www.jianshu.com/p/a17a8fa10e4a>