Markdown語法簡明手冊——基於Typora編輯器

前言

    Markdown是一種極爲簡潔的標記語言，使用簡潔的語法代替排版，讓咱們可以專一於文字。Markdown的語法簡潔明瞭、易於學習，並且功能比純文本強，格式轉換方便，可以輕鬆的導出爲HTML、PDF等等格式文件。

    Typora是一款免費的輕量級Markdown編輯器，它用創新徹底顛覆了這種傳統的交互模式，它只使用一個窗口，卻能優雅地實現同時將代碼編輯與預覽「一體化」結合起來！從而爲用戶帶來更加流暢直觀的「所見即所得的 Markdown 寫做體驗」。極簡的 Typora 沒有任何多餘的功能，純粹卻仍能提供高效天然的寫做體驗，不管對重度仍是輕度用戶都是很是理想的工具。

本次Typora簡明使用手冊爲結合Markdown語法和Typora編輯器所得。

一. 基礎語法

1.1 分級標題

Typora能夠根據當前文檔的標題層級，自動生成並顯示大綱，窗口的右下角並有字數顯示。

第一種寫法：

這是一個一級標題
==================
這是一個二級標題
------------------

第二種寫法：

# 一級標題 或快捷鍵Ctrl+1
## 二級標題 或快捷鍵Ctrl+2
### 三級標題 或快捷鍵Ctrl+3
#### 四級標題 或快捷鍵Ctrl+4
##### 五級標題 或快捷鍵Ctrl+5
###### 六級標題 或快捷鍵Ctrl+6

1.2 字體格式

文本居中：<center>這是要居中的文本內容</center>
下劃線：<u>這是須要下劃線的內容</u> 或者快捷鍵Ctrl+U
斜體：*斜體*或_斜體_  或快捷鍵Ctrl+I
粗體：**粗體**  或快捷鍵Ctrl+B
加粗粗體：***加粗粗體***  
刪除線：~~刪除線~~

顯示效果：

<center>這是要居中的文本內容</center>

下劃線：<u>這是須要下劃線的內容</u>

斜體：斜體或_斜體_

粗體：粗體

加粗粗體：加粗粗體

刪除線：刪除線

1.3 連接

Markdown支持兩種形式的連接語法：行內式和參考式兩種形式，行內式通常使用較多

1.3.1 行內式

語法說明：

[]裏寫連接文字，()裏寫連接地址，()中的" "能夠爲連接指定title屬性，title屬性可加可不加。title屬性的效果是書表懸停在連接上會出現指定的title文字。快捷鍵Ctrl+K

[連接文字](連接地址 "連接標題")這樣的形式。連接地址與連接標題前有一個空格
歡迎來到[百度](https://www.baidu.com)

顯示效果：

歡迎來到百度

1.3.2 參考式

參考式超連接通常用在學術論文上面，或者另外一種狀況：若是一個連接在文章中多處使用，那麼使用引用的方式建立連接將方便對連接進行統一的管理。

語法說明：

參考式連接分爲兩部分,文中的寫法[連接文字][連接標記]，在文本的任意位置添加[連接標記]：連接地址 "連接標題",連接地址和鏈接標題前有一個空格。

若是連接文字自己能夠作爲連接標記，也能夠寫成[連接文字][]

常用的網站有[Google][1]、[csdn][2]以及[博客園][3]
[csdn][2]是一個不錯的[網站][]
[1]:http://www.google.com "Google"
[2]:https://blog.csdn.net/ "csdn"
[3]:https://www.cnblogs.com/ "博客園"
[網站]:https://blog.csdn.net/

常用的網站有Google、csdn以及博客園

csdn是一個不錯的[網站][]

1.3.3 自動連接

語法說明：

Markdown 支持以比較簡短的自動連接形式來處理網址和電子郵件信箱，只要是用<>包起來， Markdown 就會自動把它轉成連接。通常網址的連接文字就和連接地址同樣，例如：

自動網頁連接：<http://www.baidu.com>
自動郵箱連接：<address@www.baidu.com>

顯示效果：

自動網頁連接：http://www.baidu.com

自動郵箱連接：<address@www.baidu.com>

1.4 分隔線

你能夠在一行中用三個以上的星號、減號、底線來創建一個分隔線，行內不能有其餘東西。你也能夠在星號或是減號中間插入空格。下面每種寫法均可以創建分隔線：

***
---
____

---

---

1.5 代碼

插入程序代碼的方式有兩種，一種是利用縮進(Tab), 另外一種是利用」`」符號（通常在ESC鍵下方）包裹代碼。

語法說明：

1. 插入行內代碼，即插入一個單詞或者一句代碼的狀況，使用code這樣的形式插入。
2. 插入多行代碼，可使用縮進或者「 `code` ,具體看示例。

注意： 縮進式插入前方必須有空行

1.5.1 行內式

如何插入行內式代碼`printf()`?

顯示效果：如何插入行內式代碼printf()?

1.5.2 縮進式多行代碼

縮進4個空格或者一個製表符(Tab)

一個代碼區塊會一直持續到沒有縮進的那一行（或是文件結尾）。

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

1.5.3 用六個`包裹代碼

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

1.6 引用

語法說明：

引用須要在被引用的文本前加上>符號

多層嵌套：
>這是引用文字  
>>這是多重引用文字 
>這是一段沒法跳出多層嵌套的文字
>>>這是多重引用文字 

>這是第一段引用文字  
>這是第二段引用文字

顯示效果：

多層嵌套：

這是引用文字

這是多重引用文字
這是一段沒法跳出多層嵌套的文字

這是多重引用文字

這是第一段引用文字
這是第二段引用文字

1.7 列表

1.7.1 無序列表

使用*，+，-，表示無序列表

代碼：

- 無序列表項 一
- 無序列表項 二
- 無序列表項 三

無序列表嵌套有序列表
- 無序列表項 一
    1. 有序列表項 一
    2. 有序列表項 二
    3. 有序列表項 三
- 無序列表項 二
    - 無序列表項
    - 無序列表項

顯示效果：

• 無序列表項 一
• 無序列表項 二
• 無序列表項 三

無序列表嵌套：

• 無序列表項 一

  1. 有序列表項 一
  2. 有序列表項 二
  3. 有序列表項 三

• 無序列表項 二

  • 無序列表項
  • 無序列表項

1.7.2 有序列表

有序列表則使用數字接着一個英文句點。

1. 有序列表項 一
2. 有序列表項 二
3. 有序列表項 三

顯示效果：

1. 有序列表項 一
2. 有序列表項 二
3. 有序列表項 三

1.7.3 Todo列表

* [x] Java
* [ ] C
* [ ] C++

顯示效果：

• [x] Java
• [ ] C
• [ ] C++

1.8 表格

快捷鍵：Ctrl+或者|國籍|省份|市區|以後按回車

學號	姓名	分數
12	小明	98
15	小紅	95
13	小杰	97

1.9 插入圖像

圖片的建立方式與超連接類似，分爲行內式和參考式寫法。

語法中圖片的Alt的意思是若是圖片由於某些緣由不能顯示，就用定義的圖片Alt文字來代替圖片。圖片Title表示鼠標懸停於圖片上時出現的文字。Alt和Title都不是必須的。

1.9.1 行內式

語法說明：![圖片Alt](圖片地址 "圖片Title")

男孩：
![男孩](https://tvax4.sinaimg.cn/crop.0.0.512.512.180/bfd1651fly8fw54r4xhfuj20e80e8t94.jpg "男孩")

顯示效果：

男孩：

1.9.2 參考式

語法說明：在文檔要插入圖片的地方寫![圖片Alt][標記]

在文檔的最後協商[標記]：圖片地址 」Title「

男孩：
![男孩][boy]
[boy]:https://tvax4.sinaimg.cn/crop.0.0.512.512.180/bfd1651fly8fw54r4xhfuj20e80e8t94.jpg "男孩"

顯示效果：

男孩：

1.10 基礎語法補充

1.10.1 換行

方法1.連續兩個空格+回車
方法2.使用html語言換行標籤<br>

1.10.2 縮進字符

  不斷行的空白格 或 
  半角的空白 或 
  全角的空白 或 

顯示效果：

  不斷行的空白格 或 
  半角的空白 或 
  全角的空白 或 

1.10.3 特殊符號

Markdown中的語法符號，前面加反斜線\便可顯示符號自己。

\\    反斜線
\`    反引號
\*    星號
\_    底線
\{\}    花括號
\[\]    方括號
\(\)    括弧
\#    井號
\+    加號
\-    減號
\.    英文句點
\!    驚歎號

其餘特殊字符，更多字符對應的Unicode碼，參考網站 https://unicode-table.com/cn/

❤✓

顯示效果

❤✓

二. 高級用法

2.1 LaTex公式

質能守恆方程能夠用一個簡潔的方程式表示：$$E=mc^2$$

顯示效果：
質能守恆方程能夠用一個簡潔的方程式表示：

$$ E=mc^2 $$

更多公式使用方式參考 mathjax

2.2 流程圖

更多流程圖語法參考 flowchart、 Mermaid流程圖

2.3 甘特圖

更多甘特圖語法參考 mermaid

2.4 序列圖

更多序列圖語法參考 bramp、 mermaid

2.5 錨點

網頁中，錨點其實就是頁內超連接，也就是連接本文檔內部的某些元素，實現當前頁面中的跳轉。好比我這裏寫下一個錨點，點擊回到目錄，就能跳轉到目錄。 在目錄中點擊這一節，就能跳過來。還有下一節的註腳。這些根本上都是用錨點來實現的。

注意：

1. Markdown Extra 只支持在標題後插入錨點，其它地方無效。
2. Leanote 編輯器右側顯示效果區域暫時不支持錨點跳轉，因此點來點去發現沒有跳轉沒必要驚慌，可是你發佈成筆記或博文後是支持跳轉的。

語法描述：
在你準備跳轉到的指定標題後插入錨點{#標記}，而後在文檔的其它地方寫上鍊接到錨點的連接。

## 標題 {#1}
跳轉到[1](#1)

顯示效果：跳轉到目錄

2.6 內容目錄

在段落中填寫[TOC]以顯示全文內容的目錄結構

顯示效果：詳情見文檔目錄。

2.7 註腳

語法說明：在須要添加註腳的文字後加上腳註名字[^註腳名字],稱爲加註。 而後在文本的任意位置(通常在最後)添加腳註，腳註前必須有對應的腳註名字。

注意：經測試註腳與註腳之間必須空一行，否則會失效。成功後會發現，即便你沒有把註腳寫在文末，經Markdown轉換後，也會自動歸類到文章的最後。

使用Markdown[^1]能夠效率的書寫文檔，直接轉換成HTML[^2]
[^1]:Markdown是一種純文本標記語言

[^2]:HyperText Markup Language 超文本標記語言

顯示效果：

使用Markdown¹能夠效率的書寫文檔，直接轉換成HTML²

2.8 生成側邊欄TOC/目錄

先將markdown文件(必須存在目錄結構，即不一樣級別的標題)導出爲html文件，用文本編輯器打開其中的 markdownToc.html 。裏面標記了兩條很明顯的內容分割線，你只須要把本身的html文檔的正文部分複製到兩條內容分割線之間便可，無需進行其餘編輯。

具體使用方法請訪問 側邊欄

2.9 HTML應用

2.9.1 HTML代碼顯示效果

在代碼區塊裏面， & 、 < 和 > 會自動轉成 HTML 實體，這樣的方式讓你很是容易使用 Markdown 插入範例用的 HTML 原始碼，只須要複製貼上，剩下的 Markdown 都會幫你處理，例如：

<div class="footer">
   © 2019 Guangzhou Corporation
</div>

<table>
    <tr>
        <th rowspan="2">球員</th>
        <th>火箭</th>
        <th>湖人</th>
        <th>勇士</th>
    </tr>
    <tr>
        <td>詹姆斯·哈登</td>
        <td>勒布朗·詹姆斯</td>
        <td>斯蒂芬·庫裏</td>
    </tr>
</table>

HTML原始碼顯示效果：

<div class="footer">
© 2019 Guangzhou Corporation
</div>

球員	火箭	湖人	勇士
	詹姆斯·哈登	勒布朗·詹姆斯	斯蒂芬·庫裏

2.9.2 HTML代碼設置字體、字號與顏色

使用內嵌HTML的方法，使普通文本內容具備必定的格式。

<font fac = "黑體">我是黑體字</font>
<font face= "微軟雅黑">我是微軟雅黑</font>
<font color="#0099ff" size=7 face="黑體">html代碼</font>

<table><tr><td bgcolor=orange>背景色是：orange</td></tr></table>

顯示效果：
<font fac = "黑體">我是黑體字</font>
<font face= "微軟雅黑">我是微軟雅黑</font>
<font color="#0099ff" size=7 face="黑體">HTML代碼</font>

背景色是：red

文章已經發布在微信公衆號，習慣微信看文章的能夠關注微信公衆號：加二減壹

---

1. Markdown是一種純文本標記語言 ↩
2. HyperText Markup Language 超文本標記語言 ↩