Markdown語法快速參考指南，包含標題、重點、列表、連結、圖片、程式碼等基本語法說明
轉載自：bit.ly/mdcheat
這篇文章旨在作為快速參考與展示。要更多完整的資訊，請見 John Gruber 原本的規格與 Github 偏好的 Markdown（Github-flavored Markdown，簡寫為GFM）資訊頁。
如果你正在找 Markdown Here 的小抄（Cheatsheet），這裡也有一篇。你也可以看看更多 Markdown 的工具。
譯註：可以參考這份中文版文件，有更詳盡的 Markdown 語法說明；如果需要可以練習的線上編輯器，可以試試看HackMD。
標題
Source codetsx
重點
Source codetsx
重點，又被稱為斜體，在兩邊加上 星號 或是 下劃線 。
更強的重點，又稱為粗體，在兩邊加上 兩個星號 或是 兩個下劃線 。
也可以用 星號與 下劃線 結合重點。
刪除線使用兩個波浪符號。 刪除這個。
列表
（在這個例子裡，前置與後面的空白以點的方式顯示：⋅） (In this example, leading and trailing spaces are shown with with dots: ⋅)
Source codetsx
-
第一個有序列表項目
-
另一個項目
- 無序子列表
-
實際數字不重要，只要它是一個數字
- 有序子列表
-
與其他項目
要在列表項目下加入段落，只要縮進就好了。注意前面的空白行，以及前置的空白（至少要一個空白，不過我們在這裡會使用三個空白以剛好對齊原始的文字）。
要使文字段行而不會成為新的段落，你只需要在後面加上兩個空白。
注意這行已經分開了，不過還是在同樣的段落中。 （如果不要求後面的兩個空格，就為伴了典型的 GFM 斷行格式。）
- 無序列表可以使用星號
- 或減號
- 或加號
連結
有兩個方法可以建立連結
Source codetsx
或讓他空白並使用連結文字本身。
網址，或是尖括號中的網址會自動轉換成連結。 http://www.example.com 或 http://www.example.com 甚至有時候 example.com 也可以（只是舉例，Github上無效）。
引用連結可以在一些文字後面。
圖片
Source codetsx
這是我們的 Logo（把游標指向 Logo 可以看到標題文字）
行內樣式：
引用樣式:
程式碼與語法高亮
程式碼區塊是 Markdown 規格的一部分，不過語法高亮不是。無論如何，許多渲染器──如 Github 和 Markdown Here ──支援語法高亮。每個渲染器支援的程式語言，以及程式語言的名字寫法都不一樣。Markdown Here 支援幾十種語言（以及不一定是真的程式語言，像 diffs 與 HTTP headers）的語法高亮；要看完整的列表，以及語言的名稱，請見 highlight.js 的示範頁。
Source codetsx
行內的 程式碼 用 反引號 包圍起來。
程式碼區塊可以用只有三個反引號```的一行圍起來，或是以四個空格縮排。我建議用三個反引號的方式圍起來 ── 這比較簡單，而且只有這個方式支援語法高亮。
Source codetsx
Source codejavascript
Source codepython
Source codetsx
表格
Markdown 的核心標準沒有表格，不過表格是 GFM 的一部分，而且 Markdown Here 支援表格。這是在電子郵件中加入表格的好方法 － 本來是需要從其他應用程式複製貼上的工作。
Source codetsx
冒號可以用來標示欄位的對齊方式。
| Tables | Are | Cool |
|---|---|---|
| 第三欄 | 靠右對齊 | $1600 |
| 第二欄 | 置中對齊 | $12 |
| 斑馬條紋 | 是整齊的 | $1 |
每個標頭元件都要用至少三個破折號分隔開來。 最外面的豎線可以省略，你也不需要讓原始的文字排列整齊。你也可以使用行內樣式的 Markdown。
| 不 | 漂亮 | 的文字 |
|---|---|---|
| 依然 | 渲染的 | 很好 |
| 1 | 2 | 3 |
引用文字
Source codetsx
在電子郵件中，引用文字可以很方便的模擬回應的文字。 這行也在同樣的引用區塊。
引用區塊結束
就算這行很長，只要包裹的好，依然可以很好的被引用。哦，我們繼續寫以保證每個人都確實的被包在裡面。喔，你也可以在引用文字中 放入 其他 Markdown 語法。
行內 HTML
你也可以在 Markdown 裡面撰寫原始的 HTML，這些 HTML 一樣大多數運作的很好。
Source codetsx
- 定義列表
- 有時候，人們偶爾會用到。
- 在 HTML 中撰寫 Markdown
- *無法* 運作的 **非常** 好。改用 HTML標籤。
水平線
Source codetsx
三個或更多個……
連字符
星號
下劃線
斷行
如果你想要學習斷行如何運作，我基本上建議最好就是實驗看看 ── 按 Enter 一下（也就是，插入一個換行符號），接著再按一次 (也就是，插入兩個換行符號)，看看會發生什麼。你很快就會得到你想要的。「Markdown Toggle」是你的好朋友。
你可以試試看這裡的一些方式：
Source codetsx
我們從這一行開始。
兩個換行符號分開了這行和前面那一行，所以這會變成 分開的段落 。
這行也是個分開的段落，不過…… 只有一個換行符號分開這行，所以這是 同段落 中的分開兩行。
（技術提示: Markdown Here 使用 GFM 的換行，所以不用使用 Markdown 原先的兩個空格換行法。）
Youtube 影片
Youtube 影片無法直接被加入，不過我們可以加入圖片，在圖片上設定連結到影片，像這樣：
Source codetsx
或是，用單純的 Markdown，不過會無法改變圖片的大小與邊框：
Source codetsx
可以在 git commit 裡面用 #bugID 的方式引用一個 bug，比如說 #1。
License: CC-BY