Markdown 使用教程

前言

　　之前常常在 github 中看到 .md 格式的文件，一直沒有注意，也不明白爲何文本文檔的後綴不是 .txt ,後來無心中看到了 Markdown，看到了用這個東西寫得一些web界面等特別的規整漂亮，頓時不明覺厲。後來本身學習了一下，感受這個語言確實簡潔、美觀，現推薦出來供你們學習和玩玩，但願能對你有用。

　　本文圖文並茂，避免了單純看語法的枯燥和繁瑣，其實，學習一門新東西真的其樂無窮！

簡介　　

Markdown 是一種用來文本處理的輕量級 「標記語言」，它用簡潔的語法代替排版，而無需像Microsoft的Word同樣須要花費大量的時間進行排版、字體設置。它使咱們專心於碼字，用「標記」語法，來代替常見的排版格式。Markdown不止能夠處理文本，使得文字更美觀，還支持圖像、表格等的插入，大大方便了咱們的寫做。例如此文從內容到格式，甚至插圖，一個鍵盤能夠搞定了，無需鼠標！

　　目前來看，支持 Markdown 語法的編輯器有不少，包括不少網站（例如簡書）也支持了 Markdown 的文字錄入。Markdown 從寫做到完成，導出格式爲所欲爲，你能夠導出 HTML 格式的文件用來網站發佈，也能夠十分方便的導出 PDF 格式，甚至能夠利用 CloudApp 這種雲服務工具直接上傳至網頁用來分享你的文章，全球最大的輕博客平臺 Tumblr，也支持 Mou 這類 Markdown 工具的直接上傳。

　　目前，咱們的 博客園 一樣支持了Markdown文本的編輯，具體如何設置請往下看！

Markdown特色

• 專一你的文字內容而不是排版樣式；
• 輕鬆的導出 HTML、PDF 和自己的 .md 文件；
• 純文本內容，兼容全部的文本編輯器與字處理軟件；
• 可讀，直觀。適合全部人的寫做語言。

教程

簡明教程：

• http://wowubuntu.com/markdown/basic.html

詳細教程

• http://wowubuntu.com/markdown/index.html

博客園配置Markdown編輯器

1. 進入博客後臺
   
2. 點擊「設置默認編輯器」
3. 選中 Markdown並保存
4. 回到隨筆界面點擊「添加隨筆」
5. 在「Markdown編輯器」中輸入相應的代碼
   
   

---

語法

1. 標題

標題經過 # 的個數來進行區分，Mardown總共支持6級標題。

2. 段落 & 換行

2.1. 首行縮進/空格:

•  : 英文空格(半角)
  
•  : 中文空格(全角)
  
• 輸入法切換至全角，雙擊 空格 「推薦」
• 半方大的空白   或 &#8194
• 全方大的空白  或 &#8195
• 不斷行的空白格   或 &#160

2.2. 強制換行

　　連續的字符串，若是你想要換行，每每打「Enter」是無論用的，正確的換行方法爲在 「在須要換行的地方插入 >=2 個 空格」

2.3. 空行

兩種方式：

• 在markdown中加入 >=2 個空行.
• 使用<br> 【推薦】
  　　
  

3. 列表

在Markdown下，有四種列表：有序和無序；

• 有序列表：採用 1. 2. 3.的形式
• 無序列表：採用前面加 * - + 的方式，支持多級嵌套
  
• 未完成列表：- [ ]，每一個符號間均有空格
• 已完成列表：- [x]，注意空格使用
  PS: 符號與文字之間必須有 空格

4. 引用 (Quote)

若須要引入有出處的一段話等，能夠採用引用的方式實現，實現方式爲在行開始處加入>,以下所示：

5. 字體設置

• 粗體：
  字符串先後均加上 **
• 斜體
  字符串先後均加上 *
  
• 刪除線
  字符串先後各加 ~~
  
• ++下劃線++
  字符串先後各加 ++
  
• == 字體背景色 ==
  字符串先後各加 ==
  
• 標記
  字體先後加上 ` (Esc下方的那個鍵)

6. 分割帶

當上下文不屬於同一模塊或者無甚關聯時刻，可使用分隔符進行隔開；分隔符的格式以下：

• 連續多個-(>=3)
• 連續多個*(>=3)
  
• 連續多個下劃線 _ (>=3)
• PS：以上，分隔符中間能夠有空格，但分割行不可有其它字符存在

7. 圖片和連接

• 圖片
  ![]() : [圖片名稱] (圖片網絡地址)
• 連接
  []() ： [連接名稱(可自定義)] (連接地址)

8. 代碼塊

和程序相關的寫做或是標籤語言原始碼一般會有已經排版好的代碼區塊，一般這些區塊咱們並不但願它以通常段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會用製表符來將代碼包起來。
代碼塊一直持續到沒有縮進的那一行(或是文件的結尾)

#include <iostrem> 
    using namespace std;  
    int main(int argc, char **argv) {
        cout << "hello,world!";
    }

9. 網址自動轉換

Markdown 支持以比較簡短的自動連接形式來處理網址和電子郵件信箱，只要是<>包起來， Markdown 就會自動把它轉成連接。通常網址的連接文字就和連接地址同樣，例如：

這個是個人博客地址：https://home.cnblogs.com/u/Jimmy1988/
個人郵箱地址是：JimmyNie2017@163.com

10. 轉義

Markdown 能夠利用反斜槓來插入一些在語法中有其它意義的符號，例如：若是你想要用星號加在文字旁邊的方式來作出強調效果，你能夠在星號的前面加上反斜槓：

*literal asterisks*

Markdown 支持如下這些符號前面加上反斜槓來幫助插入普通的符號：

\ 反斜線
` 反引號
* 星號
_ 下劃線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 感嘆號

11. 生成目錄

• 前提條件：

  標題的創建是採用MD格式實現的，目錄的生成建議放在文本最開始部分（固然也能夠嵌入在文中）。

• 語法

  [TOC]，中間不要有空格

• 注意事項

  目錄的生成並非每一個編輯器都支持的，至今我用過的編輯器 有道雲筆記是支持的。

12. 表格

表格的作法一般爲：

header 1 | header 2
--- |---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2

可用`<br>進行單元格內換行； 可是暫時不支持合併單元格

---

工具推薦

windows平臺

• Markdown Pad
• Markpad

Linux平臺

• ReText

Mac平臺

• Markable.in
• Dillinger.io

瀏覽器插件

• MaDe(chrome)

在線編輯器

• 麻花：支持在線編輯，關鍵支持VIM命令

高級應用

• Sublime Text3 + Markdown Editor + 教程

更多工具

• http://www.williamlong.info/archives/4319.html

---

轉載連接：http://www.cnblogs.com/Jimmy1988/p/7053875.html