Markdown 語法和 MWeb 寫做使用說明(我的留存)

本人使用的是 MWeb Lite 工具，Mac 版 。

 

# Markdown 語法和 MWeb 寫做使用說明

 

## Markdown 的設計哲學

 

> Markdown 的目標是實現「易讀易寫」。

> 不過最須要強調的即是它的可讀性。一份使用 Markdown 格式撰寫的文件應該能夠直接以純文字發佈，並且看起來不會像是由許多標籤或是格式指令所構成。

> Markdown 的語法有個主要的目的：用來做為一種網路內容的*寫做*用語言。

 

<!-- more -->

 

## 本文約定

 

若是有寫 `效果以下：`， 在 MWeb 編輯狀態下只有用 `CMD + R` 預覽才能夠看效果。

 

## 標題

 

Markdown 語法：

 

```

# 第一級標題 `<h1>` 

## 第二級標題 `<h2>` 

###### 第六級標題 `<h6>` 

```

 

效果以下：

 

# 第一級標題`<h1>` 

## 第二級標題`<h2>` 

###### 第六級標題 `<h6>` 

 

 

 

## 強調

 

Markdown 語法：

 

```

*這些文字會生成`<em>`*

_這些文字會生成`<u>`_

 

**這些文字會生成`<strong>`**

__這些文字會生成`<strong>`__

```

 

在 MWeb 中的快捷鍵爲： `CMD + U`、`CMD + I`、`CMD + B`

效果以下：

 

*這些文字會生成`<em>`*

_這些文字會生成`<u>`_

 

**這些文字會生成`<strong>`**

__這些文字會生成`<strong>`__

 

## 換行

 

四個及以上空格加回車。

若是不想打這麼多空格，只要回車就爲換行，請勾選：`Preferences` - `Themes` - `Translate newlines to <br> tags`

 

## 列表

 

### 無序列表

 

Markdown 語法：

 

```

* 項目一 無序列表 `* + 空格鍵`

* 項目二

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

* 項目二的子項目二

```

 

在 MWeb 中的快捷鍵爲： `Option + U`

效果以下：

 

* 項目一 無序列表 `* + 空格鍵`

* 項目二

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

* 項目二的子項目二

 

### 有序列表

 

Markdown 語法：

 

```

1. 項目一 有序列表 `數字 + . + 空格鍵`

2. 項目二 

3. 項目三

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

2. 項目三的子項目二

```

 

效果以下：

 

1. 項目一 有序列表 `數字 + . + 空格鍵`

2. 項目二 

3. 項目三

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

2. 項目三的子項目二

 

### 任務列表（Task lists）

 

Markdown 語法：

 

```

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

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

```

 

效果以下：

 

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

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

 

## 圖片

 

Markdown 語法：

 

```


格式: 

```

 

`Control + Shift + I` 可插入Markdown語法。

若是是 MWeb 的文檔庫中的文檔，還能夠用拖放圖片、`CMD + V` 粘貼、`CMD + Option + I` 導入這三種方式來增長圖片。

效果以下：

 


 

## 連接

 

Markdown 語法：

 

```

email <example@example.com>

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

自動生成鏈接  <http://www.github.com/>

```

 

`Control + Shift + L` 可插入Markdown語法。

若是是 MWeb 的文檔庫中的文檔，拖放或`CMD + Option + I` 導入非圖片時，會生成鏈接。

效果以下：

 

Email 鏈接： <example@example.com>

[鏈接標題Github網站](http://github.com)

自動生成鏈接像： <http://www.github.com/> 這樣

 

## 區塊引用

 

Markdown 語法：

 

```

某某說:

> 第一行引用

> 第二行費用文字

```

 

`CMD + Shift + B` 可插入Markdown語法。

效果以下：

 

某某說:

> 第一行引用

> 第二行費用文字

 

## 行內代碼

 

Markdown 語法：

 

```

像這樣便可：`<addr>` `code`

```

 

`CMD + K` 可插入Markdown語法。

效果以下：

 

像這樣便可：`<addr>` `code`

 

## 多行或者一段代碼

 

Markdown 語法：

 

```js

function fancyAlert(arg) {

  if(arg) {

    $.facebox({div:'#foo'})

  }

 

}

```

 

`CMD + Shift + K` 可插入Markdown語法。

效果以下：

 

```js

function fancyAlert(arg) {

if(arg) {

$.facebox({div:'#foo'})

}

 

}

```

 

## 順序圖或流程圖

 

Markdown 語法：

 

```sequence

張三->李四: 嘿，小四兒, 寫博客了沒?

Note right of 李四: 李四愣了一下，說：

李四-->張三: 忙得吐血，哪有時間寫。

```

 

```flow

st=>start: 開始

e=>end: 結束

op=>operation: 個人操做

cond=>condition: 確認？

 

st->op->cond

cond(yes)->e

cond(no)->op

```

 

效果以下（ `Preferences` - `Themes` - `Enable sequence & flow chart` 纔會看到效果 ）：

 

```sequence

張三->李四: 嘿，小四兒, 寫博客了沒?

Note right of 李四: 李四愣了一下，說：

李四-->張三: 忙得吐血，哪有時間寫。

```

 

```flow

st=>start: 開始

e=>end: 結束

op=>operation: 個人操做

cond=>condition: 確認？

 

st->op->cond

cond(yes)->e

cond(no)->op

```

 

更多請參考：<http://bramp.github.io/js-sequence-diagrams/>, <http://adrai.github.io/flowchart.js/>

 

## 表格

 

Markdown 語法：

 

```

第一格表頭 | 第二格表頭

--------- | -------------

內容單元格 第一列第一格 | 內容單元格第二列第一格

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

```

 

效果以下：

 

第一格表頭 | 第二格表頭

--------- | -------------

內容單元格 第一列第一格 | 內容單元格第二列第一格

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

 

 

## 刪除線

 

Markdown 語法：

 

加刪除線像這樣用： ~~刪除這些~~

 

效果以下：

 

加刪除線像這樣用： ~~刪除這些~~

 

## 分隔線

 

如下三種方式均可以生成分隔線：

 

***

 

*****

 

- - -

 

效果以下：

 

***

 

*****

 

- - -

 

 

## MathJax

 

Markdown 語法：

 

 

```

塊級公式：

$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

 

\\[ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =

1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}

{1+\frac{e^{-8\pi}} {1+\ldots} } } } \\]

 

行內公式： $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

```

 

效果以下（`Preferences` - `Themes` - `Enable MathJax` 纔會看到效果）：

 

塊級公式：

$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

 

\\[ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =

1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}

{1+\frac{e^{-8\pi}} {1+\ldots} } } } \\]

 

 

行內公式： $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

 

 

## 腳註（Footnote）

 

Markdown 語法：

 

```

這是一個腳註：[^sample_footnote]

```

 

效果以下：

 

這是一個腳註：[^sample_footnote]

 

[^sample_footnote]: 這裏是腳註信息

 

 

## 註釋和閱讀更多

 

<!-- comment -->

<!-- more -->

Actions->Insert Read More Comment *或者* `Command + .`

**注** 閱讀更多的功能只用在生成網站或博客時。

 

## TOC

 

Markdown 語法：

 

```

[TOC]

```

 

效果以下：

 

[TOC]