1. 程式人生 > >Markdown快速上手指南

Markdown快速上手指南

因為以後更新部落格要用到這個工具,這裡就簡單介紹一下,也算是快速上手的筆記,此筆記也是由Markdown進行編寫。發現Markdown的排版還是很漂亮的,和LaTeX排版那樣,但比LaTeX簡單多了。

Markdown是一種“電子郵件”風格的標記語言。

Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文字格式編寫文件,然後轉換成格式豐富的HTML頁面。 —— [ 維基百科 ]

目錄:

標題

在Markdown中,標題在文字前面加上 # 即可。總共有六級標題,標題字號逐漸降低。

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
注:# 和 【標題】之間建議保留一個字元的空格,這是最標準的Markdown寫法。有時候為了美觀,也會在標題後面加上#號,但其實標題欄只有前面的井號起作用。

列表

在Markdown中,列表格式需要在文字前面加上 - 即可。例如:
- 文字1
- 文字2
- 文字3

對應生成無序列表:

  • 文字1
  • 文字2
  • 文字3

如果是有序列表,在文字前面加上1. 2. 3. 就可以了。例如:
1. 文字1
2. 文字2
3. 文字3

對應生成有序列表:

  1. 文字1
  2. 文字2
  3. 文字3

注:-,1. 和文字之間保留一個字元的空格。

連結和圖片

在Markdown中,插入連結使用 [顯示文字](連結地址) 這樣的語法即可。例如:

[我的主頁](www.liurongbo.com)

生成這樣一個連結:

我的主頁

在Markdown中,插入圖片使用![](圖片連結地址)這樣的語法即可。例如:

注:插入圖片的語法和連結的語法很像,只是前面多了一個 ! 。

假如圖片的連結中帶括號怎麼辦?比如這張圖片:

然後我們想會不會和語法中的括號()相覆蓋?
但我這樣寫:

看來是哥哥我想多了。

引用

當我們寫東西的時候引用了他人的文字,這個時候就要用到引用的格式。在Markdown中,只要在引用的文字前面加上 > 即可。例如:

>生活就像海洋,只有意志堅強的人才能到達彼岸。 ——致那年英語

最終顯示的就是:

生活就像海洋,只有意志堅強的人才能到達彼岸。 ——致那年英語

注:> 和文字之間要保留一個字元的空格。

引用內的引用,用 > 進行巢狀就可以實現:

第一個引用行

第二級引用行

回到第一個引用行

粗體和斜體

Markdown的粗體和斜體也非常簡單,用兩個 * 包含一段文字就是粗體的語法,用一個 * 包含一段文字就是斜體的語法。例如:

生活就像海洋,只有**意志堅強**的人才能到達彼岸。 ——*致那年英語*

最終顯示的就是:

生活就像海洋,只有意志堅強的人才能到達彼岸。 ——致那年英語

程式碼引用

需要引用程式碼時,如果引用的語句只有一段,不分行,可以用 ` 將語句包含起來。如果引用的語句為多行,可以將 “` 置於這段程式碼的首行和末行。例如:

單行程式碼引用:

`hello world`

顯示為:

hello world

多段程式碼引用:

“`
hello world
world hello
hello world
“`

顯示為:

hello world
world hello
hello world

注:這裡的 ` 不是單引號,而是數字1左邊的那個,叫什麼來著。單頓號?哈哈

另外,四個空格後面的內容會自動解析為程式碼。所以敲四個空格也是可以的。

表格

表格1:
可以使用冒號來定義對齊方式:

|第一列 |第二列 |第三列 |
|——|:—-: |—–:|
|居左 |居中 |居右 |
|第一列 |第二列 |第三列 |
|第一列 |第二列 |第三列 |

顯示效果:

第一列 第二列 第三列
居左 居中 居右
第一列 第二列 第三列
第一列 第二列 第三列


表格2:

dog|bird|cat
—-|—-|—-
foo|fooo|foo
bar|barr|bar
baz|bazz|baz

顯示效果:

dog bird cat
foo fooo foo
bar barr bar
baz bazz baz


這裡我有點納悶的是,為什麼控制不了第一行的對齊方式?有空再找下文件進行補充。或有路過的筒靴告知下。

縮排

在Markdown中,縮排用:
(注:英文分號也要,但這裡用中文分號代替了,因為用英文分號就變成空格看不見了^_^)

1.半方大的空白 或 例如:

    生活就像海洋,
只有意志堅強的人才能到達彼岸。

顯示效果為:

    活就像海洋,
只有意志堅強的人才能到達彼岸。

2.全方大的空白 或 例如:

  生活就像海洋,
只用意志堅強的人才能到達彼岸。

顯示效果為:

  活就像海洋,
只有意志堅強的人才能到達彼岸。

3.不斷行的空白格 或 例如:

        生活就像海洋,
只用意志堅強的人才能到達彼岸。

顯示效果為:

        活就像海洋,
只用意志堅強的人才能到達彼岸。

從上面可以看出:
 相當於二分之一漢字大小空格
 相當於一個漢字大小空格
 相當於四分之一漢字大小的空格

橫線

在Markdown中,三個星號或者三個減號或者三個下劃線即可生成一條橫隔線:

例如:— 或者 *** 或者 ___

然後我們就得到橫線:

或者我們可以用中文的破折號連起來:
————————————————
但這樣得到的橫線實際上是破折號連起來的而已,長度需要自己控制。

又或者用等號=及波浪~加上點 · 這種黑科技?

=======================
~~~~~~~~~~~~~~~~~~~~~~~
=~=~=~=~=~=~=~=~=~=~=~=
~·~·~·~·~·~·~·~·~·~·~·~·~·~·~·~·~·
~·-=~·-=~·-=~·-=~·-=~·-=~·-=~·-=
哈哈,隨便試下,自己喜歡就好。

反斜槓

想插入特殊字元的話只需要在前面加上反斜槓 \ 即可,如*,#。本篇特殊字元的顯示就是用反斜槓實現的。

空行

有時為了排版好看,會插入空行。
可以直接使用html標籤,即< br >
(這裡為了顯示出來在br前後各加了一個空格)
例如:

生活就像海洋,
< br >只有意志堅強的人才能到達彼岸。

顯示效果為:

生活就像海洋,

只有意志堅強的人才能到達彼岸。

另外 #+空格 的方法也可以插入空行。
例如:

生活就像海洋,
#+空格
只有意志堅強的人才能到達彼岸。

顯示效果為:

生活就像海洋,

只有意志堅強的人才能到達彼岸。

個人感覺第二種方法的空行比第一種方法的空行要大一些。建議用第一種,畢竟html標籤,易用易識別。

段落和換行

一個 Markdown 段落是由一個或多個連續的文字行組成,它的前後要有一個以上的空行(空行的定義是顯示上看起來像是空的,便會被視為空行。比方說,若某一行只包含空格和製表符,則該行也會被視為空行)。普通段落不該用空格或製表符來縮排。

多個空行也只解析為一個空行。

回車

一個回車表示換行
兩個回車表示換段
多個回車沒有用

快捷鍵

  • 加粗 Ctrl + B
  • 斜體 Ctrl + I
  • 引用 Ctrl + Q
  • 插入連結 Ctrl + L
  • 插入程式碼 Ctrl + K
  • 插入圖片 Ctrl + G
  • 提升標題 Ctrl + H
  • 有序列表 Ctrl + O
  • 無序列表 Ctrl + U
  • 橫線 Ctrl + R
  • 撤銷 Ctrl + Z
  • 重做 Ctrl + Y

感覺這些快捷鍵超實用有木有!

定義列表

定義列表語法:
專案1
專案2
定義A
定義B
專案3
定義C
定義D
定義D的內容

腳註

(注:^前面沒有空格,這裡加空格是為了顯示)

生成一個腳註[ ^footnote]

顯示效果為:

生成一個腳註1.
[ ^footnote]: 這裡是 腳註內容,blabla…
然後我們在文章的後面就能看到腳註的內容了

目錄

[TOC]來生成目錄。例如文章開頭的目錄。

數學公式

  • 行內公式,數學公式為:Γ(n)=(n1)!nN
  • 塊級公式:
x=b±b24ac2a

更多LaTex語法請參考 這兒.
以前用LaTeX寫過很多東西,但對於公式的編輯卻極少用。LaTeX可以編寫出很優美的公式。以後用到了這部分再深入一下。

UML圖

可以渲染序列圖,例如:

“`sequence
張三->李四: 嘿,小四兒, 寫部落格了沒?
Note right of 李四: 李四愣了一下,說:
李四–>張三: 忙得吐血,哪有時間寫。
“`

顯示效果為:

Created with Raphaël 2.1.0張三張三李四李四嘿,小四兒, 寫部落格了沒?李四愣了一下,說:忙得吐血,哪有時間寫。

或者流程圖:

“`flow
st=>start: 開始
e=>end: 結束
op=>operation: 我的操作
cond=>condition: 確認?
st->op->cond
cond(yes)->e
cond(no)->op
“`

顯示效果為:

Created with Raphaël 2.1.0開始我的操作確認?結束yesno
  • 關於 序列圖 語法,參考 這兒,
  • 關於 流程圖 語法,參考 這兒.

這裡只是兩個簡單的栗子。要想隨心所用,還需要練習。不過對於複雜的圖,可以先用軟體繪製完成後插入圖片比較方便,比如谷歌線上繪圖。

離線寫部落格

即使使用者在沒有網路的情況下,也可以通過編輯器離線寫部落格(直接在曾經使用過的瀏覽器中輸入write.blog.csdn.net/mdeditor即可。Markdown編輯器使用瀏覽器離線儲存將內容儲存在本地。

使用者寫部落格的過程中,內容實時儲存在瀏覽器快取中,在使用者關閉瀏覽器或者其它異常情況下,內容不會丟失。使用者再次開啟瀏覽器時,會顯示上次使用者正在編輯的沒有發表的內容。

部落格發表後,本地快取將被刪除。 

使用者可以選擇 把正在寫的部落格儲存到伺服器草稿箱,即使換瀏覽器或者清除快取,內容也不會丟失。

注意:雖然瀏覽器儲存大部分時候都比較可靠,但為了您的資料安全,在聯網後,請務必及時發表或者儲存到伺服器草稿箱

瀏覽器相容

  1. 目前,Markdown編輯器對Chrome瀏覽器支援最為完整。建議大家使用較新版本的Chrome
  2. IE9以下不支援
  3. IE9,10,11存在以下問題
    • 不支援離線功能
    • IE9不支援檔案匯入匯出
    • IE10不支援拖拽檔案匯入

總結

總之Markdown還是簡單易用的。用來寫部落格也很合適,不用費很多時間在排版上面,不過功能的話還是LaTeX要強大許多。
如果想了解更多關於Markdown的語法,可以檢視Markdown語法說明文件
http://wowubuntu.com/markdown/
以後用的時候用到新的技巧再更新。

  1. 這裡是 腳註內容,blabla…

相關推薦

Markdown快速上手指南2

間距 upa 14. 使用 -- nal ole AMM 函數 Markdown快速上手指南 1、Markdown介紹 markdown可以實現快速html文檔編輯,格式優沒,並且不需要使用html元素。 markdown采用普通文本的形式,例如讀書筆記等易於使用的文本格式

Markdown快速上手指南

因為以後更新部落格要用到這個工具,這裡就簡單介紹一下,也算是快速上手的筆記,此筆記也是由Markdown進行編寫。發現Markdown的排版還是很漂亮的,和LaTeX排版那樣,但比LaTeX簡單多了。 Markdown是一種“電子郵件”風格的標記語言。

webpack構建工具快速上手指南

pre 去掉空格 spa net 例如 模式 面板 hand 根據 最近在研究react項目,接觸到webpack打包工具。剛接觸的時候一臉茫然,經過最近的學習,下面我來帶大家開啟webpack入門之旅。 webpack是什麽 webpack是近期最火的一款模塊加載器兼

Mac快速上手指南

資源管理 http 打開 rmi 最好 穩定性 logo 定性 mouse 上周剛入手了2017版MacBookPro,預裝macOS High Sierra。第一次接觸Mac系統,經過一周的使用,簡單總結下與Windows相比最常用的功能,快速上手。 1、Mac鍵盤實現

DPDK快速上手指南(18.02)

DPDKDPDK快速上手(linux) 本文檔主要來自linux_gsg-18.02.pdf的翻譯,翻譯肯定有不妥之處,請批評指正,我會隨後修改,不勝感激。 1. 介紹 本文檔包含有關DPDK(Data Plane Development Kit的縮寫)軟件的安裝和配置的說明,目的就是讓用戶快

Markdown快速上手

標簽 表示 軟件 head put world! 沒有 讀書筆記 指南 Markdown快速上手指南 @[markdown, 程序員, 雲筆記] 1、Markdown介紹 markdown可以實現快速html文檔編輯,格式優沒,並且不需要使用html元素。 markdown

Android BLE 快速上手指南

原文地址 本文旨在提供一個方便沒接觸過Android上低功耗藍芽(Bluetooth Low Energy)的同學快速上手使用的簡易教程,因此對其中的一些細節不做過分深入的探討,此外,為了讓沒有Ble裝置的同學也能模擬與裝置的互動過程,本文還提供了中央裝置(central)和外圍裝置(periphera

Atmel Studio 7.0 快速上手指南(基於ASF)

就在最近,Atmel終於推出了新版本IDE——Atmel Studio 7.0,該版本採用了微軟最新的 Visual Studio 2015 平臺,在速度、效能和程式碼視覺風格上都體現的淋淋盡致,用起來非常順手,下面將結合例項,介紹AtmelStudio 7.0 的使用方法。  

Docker 快速上手指南

Docker 聽其大名已久,但總是疏於操練,今天準備好好搞一下。 docker Docker 是什麼? Docker 屬於 Linux 容器的一種封裝,提供簡單易用的容器使用介面。 它是目前最流行的 Linux 容器解決方案。 Docker 將應用程式與該程式的依賴,打包在一個

mpvue 小程式快速上手指南

需要了解一些原生小程式開發流程,主要是介面呼叫方式和目錄結構。 安裝 # 全域性安裝 vue-cli $ npm install --global vue-cli # 建立一個基於 mpvue-q

Numpy快速上手指南 --- 進階篇

文章目錄 1. 廣播法則(rule) 2. 花哨的索引和索引技巧 通過陣列索引 通過布林陣列索引 ix_()函式 用字串索引 3. 線性代數 簡單陣列運算

Numpy快速上手指南 --- 基礎篇

文章目錄 概覽 建立陣列 列印陣列 基本運算 通用函式 ufunc 索引,切片和迭代 形狀操作 更改陣列的形狀 組合(stack)不同的陣列 將一個數

ThinkPHP 5.1 Swoole 快速上手指南

本篇內容主要講述了最新的think-swoole擴充套件的使用。 安裝Swoole 安裝think-swoole 啟動Swoole HTTP服務 配置檔案 守護程序模式 基本操作 Cookie和Session 檔案監控

Rancher及Docker快速上手指南(三)

......續接上一篇文章。 六、映象庫及應用 Rancher還有很多功能,在這裡都不細說了,因為這是一篇快速上手指南,講到這已經差不多了。但是還得補充下更重要的內容,上一篇通篇講的都是使用Rancher拉取公共映象來建立容器或應用,那麼如何建立和使用我們自已的私有映象,這也是初學者必須

Rancher及Docker快速上手指南(二)

......接上一篇文章 四、新增和管理容器 在Rancher通過介面方式新增容器的方式其實有兩種,一種是在上面提到的管理主機,直接新增獨立容器(獨立於Rancher平臺的容器,就算Rancher平臺停了,容器還會在各自主機保留),另一種是下一節會講到的,通過應用新增的方式新增容器(由R

Rancher及Docker快速上手指南(一)

Rancher是一個開源的企業級全棧化容器部署及管理平臺,目前我們使用的是穩定釋出的版本V1.6(2017年釋出),其中Rancher2.0也於2018年釋出,Rancher 2.0是一個簡化、加速企業Kubernetes(K8S)快速落地的產品,由於2.0版本變動太大,不便於我們入門應用,而且

RKE快速上手指南:開源的輕量級K8S安裝程式_Kubernetes中文社群

安裝Kubernetes是公認的對運維和DevOps而言最棘手的問題之一。因為Kubernetes可以在各種平臺和作業系統上執行,所以在安裝過程中需要考慮很多因素。 在這篇文章中,我將介紹一種新的、用於在裸機、虛擬機器、公私有云上安裝Kubernetes的輕量級工具——Rancher Kube

PyCharm 快速上手指南

Pycharm 作為一款針對 Python 的編輯器,配置簡單、功能強大、使用起來省時省心,對初學者友好,這也是為什麼程式設計教室一直推薦新手使用 Pycharm 的原因。本文我們將介紹 pycharm 編輯器的基本使用方法,主要包括以下幾個方面:下載安裝新建專案流程配置 P

intellij idea 快速上手指南

俗話說“磨刀不誤砍柴工”,作為一頭java程式猿長期使用eclipse系列開發工具,能滿足平常功能開發需求,用起來還算順手。當然人得不停的嘗試新的東西,比如說新的工具idea。 http://www.jetbrains.com/idea/ 為idea官網,開發

[轉]PyCharm 快速上手指南

下載安裝新建專案流程配置 PycharmPython控制檯其他參考資料1.下載安裝檔案pycharm-professional-2017.3.2 (準備python環境 , 可以是2.7或3.x)Pycharm提供免費的社群版與 付費的專業版。專業版額外增加了一些功能,如專案