Markdown 語言和 Typora 編輯器

2021.12.10 更新

Typora 最新版本要收費了，但是舊版本依然是免費的，如果對現(xiàn)有的 Bug 不介意的話，還是可以繼續(xù)下載使用免費的舊版本的。

=======================================================

為什么要用 Markdown 和 Typora

Markdown( *.md ) 是現(xiàn)在非常流行的一種文檔書寫語言，用戶只需用一些非常簡單易記的語法格式就可以輕松寫出一篇具有良好的排版和可讀性的文章。就像其作者 John Gruber 描述的那樣， "to write using an easy-to-read, easy-to-write plain text format, and optionally convert it to structurally valid XHTML or HTML". 可以把 Markdown 看作輕量級的 Latex 語言，雖然功能不如 Latex 那么強大，但是 Markdown 簡單的語法基本可以滿足普通文檔的書寫。

原則上，所有的文本編輯器都可以用來書寫 Markdown 文件，但是專用的 Markdown 編輯器更方便預覽、修改。我在選擇 Markdown 編輯器時，比較看中兩點：

  1. 有導航欄或者目錄，最好是在側(cè)邊，而不是在文檔的頭部。這樣對于比較長的文檔，可以很容易定位到某一特定位置，而不需要拉回到文檔頭部再點擊超鏈接。
  2. 可以實時顯示最終的效果，這樣書寫效率更高一些，更容易糾錯。

雖然現(xiàn)在的 Markdown 編輯器很多，但他們的交互形式基本都是將編輯和預覽分離開來的，要么是直接左右排列編輯和預覽窗口 （有些還不能自動同步滾動頁面），要么是要在兩種模式之間來回切換，實在是麻煩且不夠直觀。而 Typora 則不同，它只使用一個窗口，能同時將代碼編輯與預覽結(jié)合起來，從而為用戶帶來更加流暢直觀的所見即所得的 Markdown 寫作體驗。同時，Typora 在文檔左側(cè)提供了 outline，很方便文檔定位。 而且 Typora 左側(cè)還可以顯示文件夾目錄，具備簡單的文檔管理功能。

如何安裝Typora

安裝過程很簡單，按照 Typora官網(wǎng) 指導即可。
具體的安裝代碼如下：

wget -qO - https://typora.io/linux/public-key.asc | sudo apt-key add -
# or run:
# sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BA300B7755AFCFAE

# add Typora's repository
sudo add-apt-repository 'deb https://typora.io/linux ./'
sudo apt-get update

# install typora
sudo apt-get install typora

安裝之后，就可以直接在里面書寫了，下面總結(jié)一下自己常用的 Markdown 語法。

Markdown 基本語法

1. 標題

在想要設(shè)置為標題的文字前面加#：一個#是一級標題，二個#是二級標題，以此類推。支持六級標題。
注意： 標準語法一般在#后跟個空格再寫文字。
示例：

# 一級標題
##　二級標題
###　三級標題

效果如下：

一級標題

二級標題

三級標題

2. 字體

可以簡單的將字體加粗或者傾斜
加粗時把要加粗的文字左右分別用兩個*號包起來
傾斜時把要傾斜的文字左右分別用一個*號包起來
將要傾斜和加粗的文字左右分別用三個*號包起來
示例

**加粗**
*傾斜*
***加粗傾斜***

效果如下:
加粗
傾斜
加粗傾斜

3. 列表

要顯示有編號的列表，只需要在行首用數(shù)字+. 開頭。以該數(shù)字為起點開始編號，并逐行增加，不受后邊編號的影響。

6. text1
0. text2
3. text3

顯示效果：

  1. text1
  2. text2
  3. text3

要顯示不帶編號的列表，只需要把上述的數(shù)字+.替換成- 即可。

- text1
- text2
- text3

顯示效果：

  • text1
  • text2
  • text3

列表可以嵌套，只需要在頭部加空格：

1. text1
   - subtext1
   - subtext2
2. text2

顯示效果：

  1. text1
    • subtext1
    • subtext2
  2. text2

4. 段落 引用

語法借鑒了 EMAIL 中的格式，用 > 表示一層引用，>> 表示兩層，可以繼續(xù)嵌套，例如

> 我也很沒用，但是兩個人一起的話，就會變得很堅強。 ----古河渚
>> 能哭的地方，只有廁所，和爸爸的懷里。 ----岡崎汐

顯示效果如下：

我也很沒用，但是兩個人一起的話，就會變得很堅強。 ----古河渚

能哭的地方，只有廁所，和爸爸的懷里。 ----岡崎汐

5. 超鏈接

添加超鏈接的方式有 inline 和 referenced 兩種，格式分別如下：

# inline 方式
[text](url)

例如：
[Typora官網(wǎng)](https://www.typora.io/)

中括號里為顯示內(nèi)容，小括號里為鏈接地址
顯示效果：
Typora官網(wǎng)

# referenced 方式
[text][ref]
[ref] : https://www.typora.io/

例如：
[Typora官網(wǎng)][ref_1]
....其他文字內(nèi)容 ...
[ref_1] : https://www.typora.io/

顯示效果：
Typora官網(wǎng)

6. 插入圖片

與超鏈接幾乎相同，只不過在最前邊加上感嘆號 !。
也是有 inline 和 referenced 兩種方式
語法如下：

# inline 方式
![圖片alt](圖片地址 )

# referenced 方式
![圖片alt][ref]

[ref]: 圖片地址

圖片alt 是圖片不能正常顯示時備用的文字，但有些編輯器是當作圖片下方的標題說明。
圖片地址可以是網(wǎng)絡(luò)地址 url，也可以是本機圖片所在路徑。

例如：

![這是圖片標題文字或備用文字](http://i.imgur.com/fF8f2LM.jpg)

顯示效果如下：


這是圖片標題文字或備用文字

基本的 Markdown 語言不能設(shè)置圖片大小，好在很多 Markdown 編輯器（包括 Typora）支持 html 語言格式，因此我們可以用如下的命令插入指定大小的圖片

<img src="file_path" alt="show me if img is not loaded" width=300 height=300 align="center"> # 指定寬和高
# 或者
<img src="picture1.png" alt="drawing" style="zoom:50%"/>  # 指定縮小 50%

7. 原樣顯示代碼

單行代碼：代碼之間分別用一個反引號 (一般鍵盤布局中，數(shù)字 1 鍵左邊那個) 括起來，例如

`代碼`

多行代碼：用三個反引號括起來，例如

```
代碼
```

為了讓代碼顯示某種編程語言的風格，尤其是關(guān)鍵詞高亮，還可以指明編程語言，例如

```python
def func():
     return "something"
```

8. 表格

例如

| value1 | value2 | value3 |
| :--| :---: | ----: |
| 1 | 2 | 3|
| 4 | 5 | 6|

顯示效果

value1 value2 value3
1 2 3
4 5 6

其中 -- 的數(shù)量比較隨意，一個以上就可以了，冒號對應了左、右、中對齊排列

9. 公式

公式的書寫格式與 latex 類似。

  • 單行公式
    一般用 $ . . . $ 符號把要顯示的公式內(nèi)容括起來，例如
$ a^2 + b^2 = c^2$

顯示效果：
a^2 + b^2 = c^2

  • 多行公式
$$
\begin{align}
y &= Ax + Bu \\
z &= cx
\end{align}
$$

顯示效果：
\begin{align} y &= Ax + Bu \\ z &= cx \end{align}

  • 分段函數(shù)：
$$
\begin{cases}
y = 1 & \text{if $~~x \le 0$} \\
y = 2 & \text{if $~~x > 0$}
\end{cases}
$$

\begin{cases} y = 1 & \text{if $~~x \le 0$} \\ y = 2 & \text{if $~~x > 0$} \end{cases}

  • 矩陣
$$
A = \left[
\begin{matrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{matrix}
\right]
$$

A = \left[ \begin{matrix} 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \end{matrix} \right]

還有更簡單的書寫方式，不再額外定義括號格式，而是在矩陣環(huán)境中直接設(shè)定：

$$
A=\begin{bmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{bmatrix}
$$

A=\begin{bmatrix} 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \end{bmatrix}

除了 bmatrix，還有其他比較常用的矩陣環(huán)境如下：

圓括號

$$
A=\begin{pmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{pmatrix}
$$

A=\begin{pmatrix} 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \end{pmatrix}

大括號

$$
A=\begin{Bmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{Bmatrix}
$$

A=\begin{Bmatrix} 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \end{Bmatrix}

行列式形式

$$
A=\begin{vmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{vmatrix}
$$

A=\begin{vmatrix} 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \end{vmatrix}

范數(shù)形式

$$
A=\begin{Vmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{Vmatrix}
$$

A=\begin{Vmatrix} 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \end{Vmatrix}

10. 總結(jié)

我記得有人說過一個下午就可以學會 Latex，那么學會 Markdown 大概只需要幾分鐘吧。本文總結(jié)了常用的 Markdown 語法規(guī)則，大概可以應對絕大部分的寫作要求了。如果想更全面的學習 Markdown 語法和細節(jié)，可以參考這個教程。

注意：不同的編輯器對 Markdown 語法的解讀可能會有稍微的差別，上邊的介紹不保證在所有的 Markdown 編輯器中都有相同的預覽效果。Typora 編輯器額外提供了一些特殊的文檔結(jié)構(gòu)，例如任務列表。也可以通過界面直接選擇創(chuàng)建列表、表格等，非常方便。

Written by shaohua
Revised by QP

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容