Markdown入門 · Vicky's Blog

Markdown 是一種 「輕量級標記式語言」 ，創始人為 約翰·格魯伯（John Gruber） 。這個語言的目的是希望大家使用「易於閱讀、易於撰寫的純文字格式，並選擇性的轉換成有效的 XHTML (或是 HTML)」。

介紹

Markdown 是一種 「輕量級標記式語言」 ，它的語法簡單，不像一般的文字處理軟件 Word 或 Pages 有大量的排版、字體設置。它使我們只專心於文字和內容，用 「標記式語法」 來代替常見的排版格式。從內容到格式，甚至插圖，都是鍵盤就可以通通搞定了。

目前支持 Markdown 語法的編輯器和網站都好多。例如：MacDown、typora、Mou、GitHub、簡書等等。

Markdown 能導出多種格式，可以導出 HTML 格式的文件用來網站發佈，也可以導出 PDF 格式。

Markdown 語法參考：

特點

純文本，兼容性極強，可以用所有文本編輯器打開
Markdown 專注於文字和內容，而不是排版，能讓我們安心寫作
Markdown 的語法簡單，有極好的可讀性，常用的標記符號不超過十個
格式轉換方便，除了本身的.md 文件外，還能輕鬆轉換為 HTML、PDF 等格式
Markdown 還能支持流程圖、複雜的表格、公式等等

語法規則

代碼區域

對於程序員，文章中有代碼是肯定的。我們需要代碼框把代碼引起來，這個時候，我們可以用 3 個`把代碼引起來就可以了，


var a = 3;
int b = 33;

寫法：

	```
	code
	```

標題

可以在標題內容前輸入特定數量的#號來實現對應級別的 HTML 樣式標題。


# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

一級和二級標題還可以寫成：


一級標題
===================

二級標題
--------------------

Markdown 會轉成：


<h1>一級標題</h1>
<h2>二級標題</h2>
<h6>六級標題</h6>

列表

我們知道列表有有序列表和無序列表兩種。在 Markdown 下，只需要在文字前加上 - 或 * 即變為無序列表，而有序列表則是直接在文字前面加1. 2. 3.。


* 列表1
* 列表2
* 列表3

- 列表1
- 列表2
- 列表3


1. 列表1
2. 列表2
3. 列表3

Markdown 會轉成：


<ul>
	<li>列表1</li>
	<li>列表2</li>
	<li>列表3</li>
</ul>


<ol>
	<li>列表1</li>
	<li>列表2</li>
	<li>列表3</li>
</ol>

注意：符號與文字之間要加上一個字符的空格

引用

引用只需要在內容段落開頭前加上右尖括弧(>)就可以了。可以是開頭加或每行加，效果都是一樣。


> 這一整段的內容都會作為一個HTML的引用元素。
引用元素是會自動優化排版的（reflowable，可回流）。

或


> 這一整段的內容都會作為一個HTML的引用元素。
> 引用元素是會自動優化排版的（reflowable，可回流）。

Markdown 會轉成：


<blockquote>
	<p>這一整段的內容都會作為一個HTML的引用元素。引用元素是會自動優化排版的（reflowable，可回流）。</p>
</blockquote>

如果是引用中的引用，可以同兩個(>)開頭，如此類推，即可實現多級引用。


> 這一整段的內容都會作為一個HTML的引用元素。
>> 引用元素是會自動優化排版的（reflowable，可回流）。

換行

單一段落
```
<p>
```
多行
```
<br />
```
如果你真的想在 Markdown 中插入換行標籤<br/>，你可以在行尾輸入兩個或以上的空格，然後 Enter。這樣插入換行十分麻煩，但是「每個換行都轉換為<br/>」在 Markdown 中並不合適，所以只在你確定你需要時手動添加。

連結

文字連結。只需要使用[連結文字](連結地址)，如
```
[vicky335](https://vicky335.github.io "vicky335")
```
顯示效果：vicky335
索引連結。連結地址可以放在段落後面的注腳，前面放上連結參照標籤區分。如，先在內容行內插入
```
[連結文字][連結引用標籤]
```
然後在段落後面（或文件結尾）放上以下內容，就可以生成連結：
```
[連結引用標籤]：連結地址 "連結標題"
```
自動連結。Markdown 還支持以比較簡短的自動連結形式來處理網址和電子郵件，只要使用尖括號<>包起來，就會自動把它轉成連結。如
```
<https://vicky335.github.io>

<address@example.com>
```
顯示效果：https://vicky335.github.io address@example.com

此時，Markdown 會轉為：
```
<a href="http://example.com/">http://example.com/</a>
```

如果希望添加的連結是另開新視窗打開：

直接使用 HTML 語法


<a href="https://vicky335.github.io/" target="_blank">vicky335</a>

使用 Javascript 語言


<script>
	var links = document.links;

	for (var i = 0, linksLength = links.length; i < linksLength; i++) {
	   if (links[i].hostname != window.location.hostname) {
	       links[i].target = '_blank';
	   }
	}
</script>

使用 JQuery 的可以是：


<script>
	$(document.links).filter(function() {
	    return this.hostname != window.location.hostname;
	}).attr('target', '_blank');
</script>

有些 Markdown 的編輯器可以使用


[vicky335](https://vicky335.github.io){:target="_blank"}

Markdown 另外新窗參考： https://stackoverflow.com/questions/4425198/markdown-target-blank

圖片

插入圖片，只需要使用 ![替代文字(可省略)](圖片連結地址 "title文字") 即可。不過目前 Markdown 還不能指定圖片的寬高，如有需要，可以使用普通的 <img> 標籤。


寫法:  ![](https://vicky335.github.io/images/logo.png)

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

目前 Markdown 還不能指定圖片的寬高，如有需要，可以使用普通的<img>標籤

表格

代碼如下：


| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col *3* is    | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

顯示效果：

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

強調

斜體

使用 1 個*或用 1 個_，把需要顯示斜體的內容包住，如：
```
*斜體*

_粗體_
```
粗體

使用 2 個**或用 2 個__，把要加粗的內容包住，如：
```
**粗體**

__粗體__
```
粗斜體

使用 3 個*** 或用 3 個___，把要加粗斜體的內容包住，如：
```
***斜體***

___粗體___
```

特殊

水平分割線

在單獨一行裡使用 3 個或以上的 - - - * * * ____ ，如：
```
* * *
***
*****
- - -
---------------------------------------
```
轉義

Markdown 可以利用反斜槓來插入一些在語法中有特殊意義的符號，例如想顯示*，就在星號前加上反斜槓\*。 Markdown 支持以下這些符號前面加上反斜槓來幫助插入普通的符號：
```
\\    反斜線
\`    反引號
\*    星號
\_    下划線
\{\}  大括號
\[\]  中括號
  小括弧
\#    井號
\+    加號
\-    減號
\.    英文句號
\!    感嘆號
```
分割

使用三個-，即是---

縮進

程序中常用的 tab 縮進是


寫法：` `這樣寫就會縮進了。

特殊顯示

即 inline 代碼。用 1 個`把要顯示的內容包住，如：
```
寫法：
`我是特殊形式`
```
直接使用 Html

可以直接使用 HTML 標籤，但要在前後加上空行。

Menu

介紹

特點

語法規則

代碼區域

標題

列表

引用

換行

連結

圖片

表格

強調

特殊