背景
最近想開始寫一些文章,一個是作為業余消遣(游戲的替代品),另外也是自己的工作、生活和學習的一個記錄。工欲善其事,必先利其器,我需要選擇一款適合我的筆記軟件。主要有以下需求:
- 跨平台,多終端,打開任何一台機器,都能夠繼續寫
- 實時同步
- 支持Markdown
最開始我使用的是印象筆記,印象筆記的專業版能夠支持我的這些需求,但是印象筆記的Markdown編輯器使用起來並不是那么舒服。並且md文件中添加的圖片如果想要上傳到博客,就得一張一張的上傳。從功能來看,印象筆記功能很齊全,比如網頁截取和微信、微博轉存筆記等功能都很好用,但是僅從寫Markdown筆記的角度,印象筆記並不是那么的完美。

選擇Markdown編輯器——Typora
基於上述原因,我想選擇一款更加專業的Markdown編輯器。基於我的需求,最終選擇了Typaro
這個軟件。
選擇它的原因有以下幾點:
-
免費
-
美觀,這個編輯器真的很和我的口味
-
實時預覽,支持多種模式
- 源代碼模式
- 打字機模式
- 專注模式
-
人性化,
偏好設置
中有很豐富的Markdown偏好配置項,可根據自己的喜好進行修改配置。 -
支持導出各種格式。typora+pandoc可以支持Markdown導出多種格式。
-
配合PicGo,可以同步上傳圖床,這一點是我最喜歡的,可以大大的提升寫筆記的效率。本文便介紹Typora+PicGo+Gitee來同步上傳圖床
Typora圖像偏好設置
打開 Typora 的偏好設置窗口,點擊左側的「圖像」選項卡,在「插入圖片時…」下面有一個下拉框,里面有這樣幾個選項,如下圖所示。
- 「無特殊操作」是默認選項。
- 「復制圖片到當前文件夾(./)」意思是你在插入圖片時,將圖片復制到你正在編輯的 Markdown 文件所在的目錄下。
- 「復制圖片到 ./${filename}.assets 文件夾」意思是,在你插入圖片時,會在當前目錄下創建一個名為
${filename}.asset
的文件夾,然后把圖片保存在這個文件夾下,其中${filename}
指的是當前你正在編輯的Markdown文件的文件名。 - 「上傳圖片」就是在你插入圖片時,使用圖片上傳服務將圖片上傳到服務器。這個具體的設置請參考下一節「上傳圖片」。
- 「復制到指定路徑」當你選擇這個選項后,會出現一個輸入框讓你輸入保存圖片的路徑,這里也可以使用
${filename}
來指代當前編輯的Markdown文件的文件名。也可以點擊右邊的文件夾按鈕在彈出的對話框中選擇一個路徑。
我使用的配置如下:
因為我對YAML不了解,因此沒有勾選。
因為如果你在Markdown文件中使用了圖片,那說明這張圖片和你寫的東西是有關聯的,那最好把圖片和 Markdown 文件放在一起,這樣也便於以后查找。還要注意的是,如果你選擇了「復制圖片到當前文件夾(./)」,那么要把下面的「優先使用相對路徑」選項勾選上,這樣,Typora 在引用圖片時就會使用相對路徑,以后即使你移動 Markdown 文件到別的目錄下,只要圖片隨着 Markdown 文件一起移動, Typora 就永遠都能找到這張圖片。再配合接下來要講的「上傳圖片」,就能使 Markdown 文件的維護成本最小化。
此時插入圖片,就會自動的把該圖片保存到${filename}.asset
目錄中,markdown筆記中的圖片路徑也會是asset目錄中圖片的路徑。如下圖:

PicGo+Gitee上傳圖片
Gitee創建圖床倉庫
Gitee是開源中國(OSChina)推出的基於Git的代碼托管服務,他是目前中國最大的代碼托管的工具,實際上,除了代碼,它還支持圖片存儲。
使用Gitee的優點是比較方便,穩定,且速度較快。缺點是上傳圖床最大大小為1M,不過目前我使用圖床的需求也就是寫筆記。Gitee應該也夠用。
步驟一:新建倉庫
按照下圖進行配置,需要注意的是倉庫需要選擇為開源。另外,需要留意倉庫的歸屬和路徑,這個是后續我們需要在PicGo
的配置文件中進行配置的。
創建私人令牌
倉庫創建好后,我們要在[個人設置]->[私人令牌]中創建私人令牌(Token
),該令牌的權限可以按照下圖進行配置,需要記錄生成的Token
。進行到這里,Gitee基本已經配置好了。
安裝並配置PicGo
安裝PicGo
PicGo
是一個用於快速上傳圖片並獲取圖片 URL 鏈接的工具,支持多種圖庫。Topora
已經原生支持PicGo
插件,我們直接在軟件內安裝即可。
這里的下拉選單有PicGo-Core(command line)
和PicGo(app)
和Custom Command
PicGo.app 和 PicGo-Core 的區別
- 目前 PicGo.app 僅有中文版。
- PicGo.app 提供了圖形用戶界面,因此與命令行界面的 PicGo-Core 相比,前者更加容易使用。
- 使用 PicGo-Core 上傳圖片耗費的計算機資源更少,因為只有在上傳圖片的時候 PicGo-Core 的進程才會運行,上傳結束后(不管成功還是失敗),進程便會退出。但是如果使用 PicGo.app 上傳,PicGo.app 會一直保持運行,無法自動退出。並且,PicGo.app 是一個電子應用程序,它會消耗更多計算資源。
- PicGo.app 和 PicGo-Core 使用不同的配置文件,但是你可以把 PicGo.app de 配置文件中的picBed下面的 json 對象復制到 PicGo-Core 的配置文件中。
- PicGo.app 還提供了其他的特性,比如上傳歷史、自動重命名等。
自定義命令
還可以通過自定義命令去上傳圖片,在自定義的命令中,可以使用上面沒有列出的工具或者甚至是你自己寫一個工具或者腳本。Typora 會自動將所有需要上傳的圖片追加到你填寫的命令后面。你自定義的命令必須在標准輸出中輸出圖片的 URL,一個占一行,Typora 會根據上傳圖片的數量從標准輸出的最后 N 行中讀取圖片的 URL。
我在這里沒有使用自定義命令,因此就沒有去了解如何使用,不再展開。
安裝插件
需要安裝gitee-uploader
插件來使PicGo
支持Gitee
圖床上傳。
找到PicGo的路徑
首先,我們需要找到picgo的路徑,可以通過點擊上傳服務中的驗證圖片上傳選項找到picgo的路徑。
安裝Node.js
我們在命令行窗口中切換到該目錄中,輸入以下命令:
.\picgo.exe install gitee-uploader
需要注意的是,安裝該插件需要使用到npm,因此我們需要安裝node.js環境。否則則會有以下報錯:
我們可以在下載 | Node.js 中文網 (nodejs.cn)中下載node.js,安裝即可。
安裝Gitee插件
安裝完成后,重新執行以下命令,即可安裝成功。
.\picgo.exe install gitee-uploader
配置PicGo
在【偏好設置】->【上傳服務設定】中打開配置文件,按照以下代碼進行配置
{
"picBed": {
"current": "gitee",
"uploader": "gitee",
"gitee": {
"branch": "master",
"customPath": "yearMonth",
"customUrl": "",
"path": "img/",
"repo": "zyfzjuer/figurebed1", # "repo": "gitee用戶名/gitee倉庫名"
"token": "e07d82fcc03eee77a924c266ac1f8297" # "token": "自己的token"
}
},
"picgoPlugins": {
"picgo-plugin-gitee-uploader": true
}
}
配置好后,再點擊驗證圖片上傳,即可查看是否配置成功。
圖片上傳成功,可以在Gitee
的倉庫中查看到圖片已經上傳。
上傳圖片
我們新建一個test.md文檔,插入一個圖片,按照之前的配置,該圖片會被保存在./test/asset
文件夾中,如下圖:

我們在圖片上點擊右鍵,下拉菜單中會有上傳圖片
的選項,點擊它,我們的圖片就會上傳到Gitee圖床中,並且該圖片的鏈接及變成了圖床中圖片的鏈接。

除了這種方法,我們還可以在【格式】>【圖像】中上傳所有本地圖片。如下圖:
需要注意的是,如果圖片所在中存在中文字符,那么直接上傳所有本地圖片就會失敗,需要一個個上傳。這個是比較麻煩的地方
使用堅果雲實現文檔同步
堅果雲的免費賬戶每個月可以有1G的免費上傳流量和3G的免費下載流量
使用堅果雲的方法不再贅述,堅果雲的官方指導手冊說的很清楚。
總結
-
使用
Typora
進行Markdown
文檔撰寫,美觀!舒適!😍 -
配置「復制圖片到
./${filename}.assets
文件夾」,便於文檔遷移。✔ -
使用PicGo+Gitee,自動同步圖片至圖床!👏
-
搭配使用堅果雲,實時同步,多終端編輯~😊