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
加粗粗體：***加粗粗體***  
刪除線：~~刪除線~~

顯示效果：

這是要居中的文本內容

下划線：這是需要下划線的內容

斜體：斜體或_斜體_

粗體：粗體

加粗粗體：加粗粗體

刪除線：刪除線

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>
自動郵箱鏈接：<[e-mail]>

顯示效果：

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

自動郵箱鏈接：[e-mail]

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^[1]可以效率的書寫文檔，直接轉換成HTML^[2]

2.8 HTML應用

2.8.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原始碼顯示效果：

© 2019 Guangzhou Corporation

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

2.8.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>

顯示效果：
我是黑體字
我是微軟雅黑
HTML代碼

背景色是：red

2.9 生成側邊欄TOC/目錄

先將markdown文件(必須存在目錄結構，即不同級別的標題)導出為html文件，用文本編輯器打開其中的 markdownToc.html 。里面標記了兩條很明顯的內容分割線，你只需要把自己的html文檔的正文部分復制到兩條內容分割線之間即可，無需進行其他編輯。

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

---

1. Markdown是一種純文本標記語言 ↩︎

2. HyperText Markup Language 超文本標記語言 ↩︎