引言
作為 開發者,你還在用 Word、Txt 去記錄日常事項和文檔嗎?
你是否在編寫這些文檔的時候發現頁面樣式單一,顯示雜亂。而且在引用代碼時還會有各種各樣的格式問題?
接下來我介紹的這款工具,或者可以有效解決這些問題。
無論你是學生,抑或是工作三五年的互聯網打工人,還是像教師、公務員這樣經常需要寫文檔和報告的群體。只要你寫過了 樣式的文檔,就一定會愛不釋手。
什么是?
是一種輕量標記語言,和 Word、PDF、HMTL 格式一樣,可以用作文章或者網頁的格式。
和其它的格式相比, 具備以下優勢:
易學易用,逼格滿滿;
格式簡潔,辨識度高,功能強大,不僅可平替掉 Office 三件套(Word、Excel 和 PPT),還能快速轉換成 PDF、HTML 等格式文本;
廣泛應用于絕大多數互聯網平臺,如 GitHub、、公眾號、知乎等。
Typora 是什么?
Typora 是目前市面上最好用的 編輯器工具,就像 Office 對于 Word 一樣 。
從 Typora1.0 版本開始,該編輯器需要付費使用,官方下載地址:%3A//typora.io/
雖然免費且未激活的比付費版本功能稍微差一些,但我們只簡單使用編輯文檔的話,免費 Beta 版已經夠用了。
免費版的軟件安裝包已經分享在文末的百度盤子里了,需者自取。
常用操作
安裝完成以后,我們可以打開 Typora 學習 格式。
1. 標題
Typora 一共有六級標題
# 一級標題 ? ? ? ? ? ? ? ? ? 快捷鍵 ?ctrl+1
## 二級標題 ? ? ? ? ? ? ? ? ?快捷鍵 ?ctrl+2
### 三級標題 ? ? ? ? ? ? ? ? 快捷鍵 ?ctrl+3
#### 四級標題 ? ? ? ? ? ? ? ?快捷鍵 ?ctrl+4
##### 五級標題 ? ? ? ? ? ? ? 快捷鍵 ?ctrl+5
###### 六級標題 ? ? ? ? ? ? ?快捷鍵 ?ctrl+6
正文內容 快捷鍵 ?ctrl+0 清除標題變為普通文本
# + 空格 + 標題內容 是一級標題,## + 空格 + 標題內容 是二級標題,以此類推一直到六級標題。
PS:# 后面一定要跟空格,或者用鼠標選擇標題文字后用 ctrl+數字快捷鍵來設置標題
效果如下:
一級標題 快捷鍵 ctrl+1二級標題 快捷鍵 ctrl+2三級標題 快捷鍵 ctrl+3四級標題 快捷鍵 ctrl+4五級標題 快捷鍵 ctrl+5六級標題 快捷鍵 ctrl+6
2. 列表2.1 有序列表
1. 一級有序列表 ? ? ? ? ? ? ?快捷鍵 ctrl+shift+[
2. 一級有序列表 ? ? ? ? ? 快捷鍵 一級有序列表下按回車
? ? ?二級有序列表 ? ? ? ? ? 快捷鍵 換行后,按Tab,從一級自動調整為二級列表
3. 一級有序列表 ? 快捷鍵 換行后,按shift+Tab,從二級自動調整為一級列表
數字 + 小數點 + 空格 是一級有序列表的格式,也可以在該行使用快捷鍵 ctrl+shift+[ 來設置有序列表。
如果想要跳出列表可以連續按兩次回車,或向下的方向鍵【注意,此時該行后面不能有內容,否則會自動轉換為列表】,效果如下:
動物
猴子
大象
植物
向日葵
荷花
石頭
芭蕉
2.2 無序列表
* 一級無序列表 ? ? ? ? ? ? ?快捷鍵 ctrl+shift+]
* 一級無序列表 ? ? ? ? ?快捷鍵 一級有序列表下按回車
? ? 二級無序列表 ? ? ? ? ? 快捷鍵 換行后,按Tab,從一級自動調整為二級列表
* 一級有序列表 ?快捷鍵 換行后,按shift+Tab,從二級自動調整為一級列表
星號 + 空格 + 內容 是一級無序列表格式,也可以在該行使用快捷鍵 ctrl+shift+] 來設置無序列表。和有序列表一樣,想要跳出列表可以連續按兩次回車,或向下的方向鍵,效果如下:
植物
石頭
芭蕉
2.3 任務列表
- [ ] 一級任務列表 ? ? ? ? ? ? ?無快捷鍵
- [ ] 一級無序列表 ? ? ? ? ?快捷鍵 一級任務列表下按回車
? ? 二級無序列表 ? ? ? ? ? ?快捷鍵 換行后,按Tab,從一級自動調整為二級列表
- [ ] 一級有序列表 ?快捷鍵 換行后,按shift+Tab,從二級自動調整為一級列表
短橫線 + 空格 + 左中括號 + 空格 + 右中括號 + 內容 是一級任務列表格式,和有序列表一樣,想要跳出列表可以連續按兩次回車,或向下的方向鍵,效果如下:
植物
石頭
芭蕉
3. 段落3.1 代碼塊
在軟件文檔的編寫里,最重要的部分就是代碼塊的展示格式。
在 Typora 里,代碼塊的格式為 ``` + 空格 + {編程語言}:
``` go go語言的代碼塊內容 ? ? 快捷鍵 ctrl+shift+k
``` java java語言的代碼塊內容 ?快捷鍵 ctrl+shift+k
```(ESC下面的英文符號) + 空格 + {編程語言}是代碼塊的格式,或者用快捷鍵 ctrl+shift+k 引用一段代碼塊。想要跳出引用塊可以按回退鍵,或向下的方向鍵,效果如下:
include<stdio.h>
int main()
{
prinf("hello world");
return 0;
}
3.2 引用塊
> 引用塊1 ? ?快捷鍵 ctrl+shift+Q
>> 引用塊2快捷鍵 引用塊1下繼續使用ctrl+shift+Q
>>> 引用塊3快捷鍵 引用塊2下繼續使用ctrl+shift+Q
大于號 + 空格 + 內容 是引用塊的格式,和代碼塊一樣,想要跳出引用塊可以按回退鍵,或向下的方向鍵,效果如下:
引用塊1
引用塊2
引用塊3
3.3 數學公式塊
數學公式塊比較復雜,需要對 math 類函數進行操作,文檔鏈接:
基本語法:
$$+回車,輸入math語法,如:
\mathbf{V}_1 \times \mathbf{V}_2 = ?\begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & ?\frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & ?\frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
效果如下:
注意,數學公式塊需要先在勾選內聯公式,重啟 Typora 后才能顯示出效果:
4. 表格
在文檔里插入表格:
|語文|數學|英語| + 回車 快捷鍵 ctrl+T
新增一行 快捷鍵 ctrl+回車
通過 豎線+列名+豎線+列名+豎線 可添加表格,也可以用快捷鍵 ctrl+T 新增,效果如下:
語文數學英語
89
99
86
87
78
98
5. 圖片
在文檔里新增圖片:
快捷鍵 ctrl+shift+i
新增圖片的格式為 英文感嘆號+左中括號+圖片名稱+右中括號+左小括號+圖片路徑+右小括號,或者用快捷鍵 ctrl+shift+i,直接輸入圖片名稱和路徑。
同時,Typora 還支持直接復制一張圖片到文檔中。但需要注意,Typora 的圖片是引用圖片的路徑來顯示的,所以當文檔發送給別的用戶后,圖片就看不到了,解決這個問題可以用圖片相對路徑。
配置:文件 -> 偏好設置 -> 圖像 -> 優先使用相對路徑
發送文檔時,把裝有圖片的目錄也發送給別人,這樣其它用戶在打開文檔時,就能正常加載圖片了。比如,像筆者這樣,在每一個文檔的同級目錄下都新建一個 imgs 文件夾:
文檔中引用圖片時,使用相對路徑:
6. 超鏈接
當文檔中需要為某段文字添加超鏈接時,Typora 支持兩種實現方式,以及文檔內跳轉和文檔外跳轉兩種類型。
6.1 利用 語法實現1)文檔外鏈接跳轉
[文本內容](超鏈接URL)例如:[百度一下](www.baidu.com)
添加文檔外的超鏈接, 的格式是 左中括號+文本內容+右中括號+左括號+URL+右括號,效果如下:
百度一下?
注意:我們在編寫 文檔時,需要把鼠標放在鏈接內容上,按住 Ctrl 鍵點擊鏈接才可以跳轉。
2)文檔內跳轉
文檔內部跳轉的格式和外部鏈接類似,不同的是 格式下,內部鏈接跳轉只支持跳轉到標題:
[文本內容](#6.-超鏈接)
添加文檔內的超鏈接, 格式是 左中括號+文本內容+右中括號+左括號+#+標題+右括號,注意:標題中的空格需要用中橫線 “-” 代替
6.2 利用 HTML 語法實現1)文檔外鏈接跳轉
Typora 很強的一點就是,它完美支持了 HTML 的很多語法,比如:我們可以用標簽 添加超鏈接
<a href="www.baidu.com">百度一下a>
HTML 語法中,超鏈接用標簽 表示,href 放入超鏈接地址,即可訪問。效果如下:
百度一下
2)文檔內跳轉
文檔內部跳轉的格式和外部鏈接類似,但是需要自己在文檔內需要跳轉的地方添加一個標簽。同時,HTML 語法鏈接跳轉支持跳轉到內部任意位置:
<span name="tag1">跳轉到我這里span>
<a href="#tag1">點擊我跳轉到標簽位置a>
HTML 語法里面,span 元素是短語內容的通用行標識器,沒有特殊語義,相當于給我們跳轉的位置加了個唯一標識,讓 鏈接知道我們想要跳轉到哪里。
7. 文本+表情1)刪除線
~~文字內容~~ ? ? ? ? ?快捷鍵 Alt+Shift+5
效果:
刪除線
2)斜體
*文字內容* ? ? ? ? ? ? 快捷鍵 Ctrl+I
效果:
斜體
3)加粗
**文本內容** ? ? ? ? ? ?快捷鍵 Ctrl+B
效果:
文本內容已加粗展示
4)下劃線
<u>文本內容u> ? ? ? ? ?快捷鍵 Ctrl+U
效果:
下劃線
5)表情符號
Typora 支持輸出表情符號,語法是 英文冒號+表情英文,常見表情如下:
:smile // 微笑
:star ?// 星星
:dog ? // 旺財
效果:
??
6)高亮
高亮是 文檔用來讓文字更醒目的標記:
==文本內容== ? ? ? ? ? ? ? ?快捷鍵 Ctrl+Shift+H
注意,第一次使用 Typora 時,高亮是默認不顯示的。我們需要在 文件 -> 偏好設置中勾選開啟高亮:
效果:
文本內容已高亮展示
8. 主題8.1 Typora 默認主題
這時,聰明好學的朋友可能發現了,這篇文檔中的加粗字體顏色,引用背景色、高亮顏色等,為什么和自己電腦里的 樣式不同呢?
這就是 Typora主題 的區別了!
Typora 為我們提供了多種文檔主題可供選擇,具體可在文檔頁面的左上角:主題(T) -> 選擇你喜歡的主題。
8.2 DIY 主題
除了 Typora 為我們提供的多種默認主題,我們還可以 DIY 自己的主題風格,Typora 和 HTML 的樣式一樣,都是用 .css 文件配置的:
打開我們的主題文件夾,修改目前使用的主題樣式,或者從 github.css 復制一個【由于我們的主題風格會模仿 “思否” 網站的樣式,所以將復制文件 github - 副本.css 改名為 sifou.css】:
在 .css 文件中,我們可以
1)設置文檔的字體大小
2)修改標題大小和顏色
3)字體加粗樣式
比如文檔中的加粗顏色為綠色【#00965e】,字體為 1.1em 大小。
顏色代碼查詢:
4)還有高亮,代碼塊等樣式設計
8.3 推薦兩款主題
我自己使用的主題,一款是"思否"的綠色清新主題,一款是在 pie 和 ursine-polar 基礎上修改的商務風主題。
1)"思否"主題概覽【本文檔用的】
2)ursine-polar 商務風主題概覽
這兩種主題,都已經放到 GitHub 了,需要的可以自取。
GitHub地址: