1. 程式人生 > 實用技巧 >小白初學Markdown必看手冊

小白初學Markdown必看手冊

一、什麼是 Markdown

Markdown 是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。

二、下載和使用

1. 客戶端

我使用的是 作業部落 出品的 Cmd Markdown,下面演示也是使用該 IDE 作為演示。

2. 網頁外掛

如果你使用的是 chrome 遊覽器,那麼可以安裝一款叫做 Markdown Here 的外掛,也是十分好用。

三、應用

  • 用來寫部落格、郵件
  • Markdown 很容易轉化成 HTML 或者 PDF
  • git 的 README.md 就是 Markdown 格式的

例如:https://gitee.com/afei_/MarkdownDemo

https://github.com/afei-cn/MarkdownDemo

四、語法介紹

注意:很多需要效果展示的地方,參考配圖中的紅色區域。

1. 標題

第一種是使用 # 表示標題,其中 # 號必須在行首,
第二種是使用 === 或者 --- 表示。

2. 分割線

使用三個或以上的 - 或者 * 表示,且這一行只有符號,注意不要被識別為二級標題即可,例如中間或者前面可以加空格。

3. 斜體和粗體

使用 *** 分別表示斜體和粗體,刪除線使用兩個 ~ 表示

4. 超連結和圖片

連結和圖片的寫法類似,圖片僅在超連結前多了一個 ! ,一般是 [文字描述] (連結)

5. 無序列表

使用 -

+* 表示無序列表,前後留一行空白,可巢狀,例如

6. 有序列表

使用 1. (點號後面有個空格)表示有序列表,可巢狀。

7. 文字引用

使用 > 表示,可以有多個 >,表示層級更深,例如

8. 行內程式碼塊

其實上面已經用過很多次了,即使用 ` 表示,例如

擴充套件:很多字元是需要轉義,使用反斜槓 \ 進行轉義

9. 程式碼塊

使用四個空格縮排表示程式碼塊,一些 IDE 支援行數提示和著色,一般使用三個 ` 表示,例如

10. 表格

直接看例子吧,第二行的 ---: 表示了對齊方式,預設左對齊,還有右對齊居中

|商品|數量|單價|
|-|-------:|:------:|

|蘋果|10|\$1|
|電腦|1|\$1000|

11. 流程圖

主要的語法為 name=>type: describe,其中 type 主要有以下幾種:
1.開始和結束:start end
2.輸入輸出:inputoutput
3.操作:operation
4.條件:condition
5.子程式:subroutine

更多語法參考:流程圖語法參考

12. 數學公式

使用 $ 表示,其中一個 $ 表示在行內,兩個 $ 表示獨佔一行。

eg : $\sum_{i=1}^n a_i=0$

支援 LaTeX 編輯顯示支援,訪問 MathJax 參考更多使用方法。

推薦一個常用的數學公式線上編譯網站:https://private.codecogs.com/latex/eqneditor.php

13.支援 HTML 標籤

例如想要段落的縮排,可以如下:

  不斷行的空白格 或 
  半方大的空白 或 
  全方大的空白 或 

點我跳轉的功能這裡演示不了,寫法如下:

<h6 id='anchor'>我是一個錨點</h6>

[點我跳轉](#anchor)

五、其它

  1. markdown 各個 IDE 的使用可能存在大同小異,一般可以參考各個 IDE 的介紹文件
  2. 本文件介紹的內容基本適用於大部分的 IDE
  3. 本文件使用的 IDE 是 “作業部落 Cmd Markdown”,官網已經下載:https://www.zybuluo.com/cmd/