Markdown 快速入門

時間 2019-11-08

原文原文鏈接

什麼是 Markdown

Markdown 是一種輕量級標記語言，創始人爲約翰·格魯伯 (John Gruber)。它容許人們「使用易讀易寫的純文本格式編寫文檔，而後轉換成有效的XHTML (或者HTML) 文檔」。 — 維基百科css

爲何設計 Markdown

Markdown 這個語言的目的是但願你們使用「易於閱讀、易於撰寫的純文字格式，並選擇性的轉換成有效的 XHTML (或是HTML)」。其中最重要的設計是可讀性，也就是說這個語言應該要能直接在字面上被閱讀，而不用被一些格式化指令標記 (如RTF與HTML)。html

相比於 HTML，Markdown 更加精簡，更加註重內容，其主要宗旨是易讀易寫。通常 Markdown 最終都是要轉換爲 HTML，用於我的博客或網頁。但藉助於某些 Markdown 編輯器 (如Typora)，咱們能夠將 Markdown 轉換爲 PDF、Word、LaTeX、Image 等常見的文件格式。git

爲何選擇 Markdown

選擇 Markdown 的理由只有一個：簡單方便、節省時間。github

優勢

語法簡潔 - 沒有編程基礎的初學者，能夠快速入門。web
注重內容 - 專一於內容編寫，再也不爲格式排版而苦惱。編程
易於閱讀 - 即使沒有通過轉換的 Markdown 文件，大部份內容仍可直接閱讀。markdown
跨平臺性 - 任何平臺均能打開 Markdown 文件，因爲是純文本文件，不存在格式兼容的問題。編輯器
導出方便 - 方便導出爲 HTML、PDF、Word(.docx)、LaTeX 等常見格式。工具

缺點

語法兼容 - 基礎語法是兼容的，但不一樣工具(平臺)的擴展語法不兼容(因爲沒有統一標準)。oop
細節控制 - Markdown只提供最基礎的格式，其顯示樣式主要由CSS控制，很難針對性的控制部份內容。

Markdown 基礎語法

標題

語法：

# 第一級標題 `<h1>`
## 第二級標題 `<h2>`
...
### 第六級標題 `<h6>`

結果：

第一級標題 `<h1>`

第二級標題 `<h2>`

第六級標題 `<h6>`

強調

粗體

語法：

**這些文字會被加粗**
__這些文字會被加粗__

結果：

這些文字會被加粗
這些文字會被加粗

斜體

語法：

*這些文字的效果會是斜體*

結果：

這些文字的效果會是斜體

換行

四個以上的空格加回車

無序列表

語法：

* 項目一 無序列表 `* + 空格鍵`
* 項目二
    * 項目二的子項目一 無序列表 `TAB + * + 空格鍵`
    * 項目二的子項目二

結果：

項目一無序列表 * + 空格鍵
項目二
- 項目二的子項目一無序列表 TAB + * + 空格鍵
- 項目二的子項目二

有序列表

語法：

1. 項目一 有序列表 `數字 + . + 空格鍵`
2. 項目二 
3. 項目三
    1. 項目三的子項目一 有序列表 `TAB + 數字 + . + 空格鍵`
    2. 項目三的子項目二

結果：

項目一有序列表 數字 + . + 空格鍵
項目二
項目三
1. 項目三的子項目一有序列表 TAB + 數字 + . + 空格鍵
2. 項目三的子項目二

任務列表

語法：

- [ ] 任務一 未作任務 `- + 空格 + [ ]`
- [x] 任務二 已作任務 `- + 空格 + [x]`

結果：

[ ] 任務一未作任務 - + 空格 + [ ]
[x] 任務二已作任務 - + 空格 + [x]

圖片

語法：

![Alt Text](url)
 示例：
 ![GitHub set up](http://zh.mweb.im/asset/img/set-up-git.gif)

結果：

連接

郵箱連接

語法：

Email連接 <example@example.com>

結果：

Email連接 <example@example.com>

普通連接

語法：

[GitHub](http://github.com)

結果：

GitHub

區塊引用

簡單使用

語法：

某某說:
> 第一行引用
> 第二行引用文字

結果：

某某說:

第一行引用
第二行引用文字

進階使用

語法：

>**平常工做**
>* 吃飯
>* 睡覺
>* 打豆豆

結果：

平常工做

吃飯

睡覺

打豆豆

引用嵌套

語法：

>對多數職場人來講，打造有價值的我的品牌很是必要。
>>它能讓你告別低水平的勤奮陷阱，讓你工做時間越久越值錢，讓你成爲職場的甲方，再也不委屈和焦慮。

結果：

對多數職場人來講，打造有價值的我的品牌很是必要。

它能讓你告別低水平的勤奮陷阱，讓你工做時間越久越值錢，讓你成爲職場的甲方，再也不委屈和焦慮。

行內代碼

語法：

`<html>` `Markdown`

結果：

<html> Markdown

多行或代碼段

語法：

/```js
  // 實際語法是：```***```
  function add(a, b) {
    return a + b;
  }
 /```

結果：

function add(a, b) {
   return a + b;
 }

表格

語法：

第一格表頭 | 第二格表頭
--------- | -------------
內容單元格 第一列第一格 | 內容單元格第二列第一格
內容單元格 第一列第二格 多加文字 | 內容單元格第二列第二格

結果：

第一格表頭	第二格表頭
內容單元格第一列第一格	內容單元格第二列第一格
內容單元格第一列第二格多加文字	內容單元格第二列第二格

刪除線

語法：

~~我被刪除了，嗚嗚~~

結果：

~~我被刪除了，嗚嗚~~

下劃線

語法：

_我有下劃線_

結果：

我有下劃線

分割線

語法：

***
*****
- - -

結果：

反斜槓

語法：

\*這裏不會顯示斜體\*

結果：

*這裏不會顯示斜體*

其它高級語法

TOC - 內容目錄 (存在兼容性)
腳註 - 這是一個腳註[^footnote]
標籤和分類
流程圖和時序圖
LaTeX 公式

Markdown 編輯器

瞭解更多的信息，請查看 Markdown 編輯器推薦

參考資源

1. Markdown: Basics （Markdown快速入門）
2. MarkDown 快速入門
3. Markdown快速入門
4. markDown快速入門
5. Markdown--快速入門
6. MarkDown的快速入門
7. markdown快速入門筆記
8. Markdown 快速入門指南
9. Markdown: Basics （快速入門）
10. markdown語法快速入門
更多相關文章...
• SQL 快速參考 - SQL 教程
• Eclipse 快速修復 - Eclipse 教程
• YAML 入門教程
• Java Agent入門實戰（一）-Instrumentation介紹與使用

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。