使用Typora+gitee圖床+堅果雲實現文檔同步


背景

最近想開始寫一些文章,一個是作為業余消遣(游戲的替代品),另外也是自己的工作、生活和學習的一個記錄。工欲善其事,必先利其器,我需要選擇一款適合我的筆記軟件。主要有以下需求:

  • 跨平台,多終端,打開任何一台機器,都能夠繼續寫
  • 實時同步
  • 支持Markdown

最開始我使用的是印象筆記,印象筆記的專業版能夠支持我的這些需求,但是印象筆記的Markdown編輯器使用起來並不是那么舒服。並且md文件中添加的圖片如果想要上傳到博客,就得一張一張的上傳。從功能來看,印象筆記功能很齊全,比如網頁截取和微信、微博轉存筆記等功能都很好用,但是僅從寫Markdown筆記的角度,印象筆記並不是那么的完美。

image-20211014195133539

選擇Markdown編輯器——Typora

基於上述原因,我想選擇一款更加專業的Markdown編輯器。基於我的需求,最終選擇了Typaro這個軟件。

選擇它的原因有以下幾點:

  • 免費

  • 美觀,這個編輯器真的很和我的口味

  • 實時預覽,支持多種模式

    • 源代碼模式
    • 打字機模式
    • 專注模式
  • 人性化,偏好設置中有很豐富的Markdown偏好配置項,可根據自己的喜好進行修改配置。

  • 支持導出各種格式。typora+pandoc可以支持Markdown導出多種格式。

  • 配合PicGo,可以同步上傳圖床,這一點是我最喜歡的,可以大大的提升寫筆記的效率。本文便介紹Typora+PicGo+Gitee來同步上傳圖床

Typora圖像偏好設置

打開 Typora 的偏好設置窗口,點擊左側的「圖像」選項卡,在「插入圖片時…」下面有一個下拉框,里面有這樣幾個選項,如下圖所示。

image-20211014201853484

  • 「無特殊操作」是默認選項。
  • 「復制圖片到當前文件夾(./)」意思是你在插入圖片時,將圖片復制到你正在編輯的 Markdown 文件所在的目錄下。
  • 「復制圖片到 ./${filename}.assets 文件夾」意思是,在你插入圖片時,會在當前目錄下創建一個名為${filename}.asset的文件夾,然后把圖片保存在這個文件夾下,其中${filename}指的是當前你正在編輯的Markdown文件的文件名。
  • 「上傳圖片」就是在你插入圖片時,使用圖片上傳服務將圖片上傳到服務器。這個具體的設置請參考下一節「上傳圖片」。
  • 「復制到指定路徑」當你選擇這個選項后,會出現一個輸入框讓你輸入保存圖片的路徑,這里也可以使用${filename}來指代當前編輯的Markdown文件的文件名。也可以點擊右邊的文件夾按鈕在彈出的對話框中選擇一個路徑。

我使用的配置如下:

image-20211014202146361

​ 因為我對YAML不了解,因此沒有勾選。

因為如果你在Markdown文件中使用了圖片,那說明這張圖片和你寫的東西是有關聯的,那最好把圖片和 Markdown 文件放在一起,這樣也便於以后查找。還要注意的是,如果你選擇了「復制圖片到當前文件夾(./)」,那么要把下面的「優先使用相對路徑」選項勾選上,這樣,Typora 在引用圖片時就會使用相對路徑,以后即使你移動 Markdown 文件到別的目錄下,只要圖片隨着 Markdown 文件一起移動, Typora 就永遠都能找到這張圖片。再配合接下來要講的「上傳圖片」,就能使 Markdown 文件的維護成本最小化。

此時插入圖片,就會自動的把該圖片保存到${filename}.asset目錄中,markdown筆記中的圖片路徑也會是asset目錄中圖片的路徑。如下圖:

![image-20211014215607368 - 副本](https://gitee.com/zyfzjuer/figurebed/raw/master/img/image-20211014215607368 - 副本.png)

PicGo+Gitee上傳圖片

Gitee創建圖床倉庫

Gitee是開源中國(OSChina)推出的基於Git的代碼托管服務,他是目前中國最大的代碼托管的工具,實際上,除了代碼,它還支持圖片存儲。

使用Gitee的優點是比較方便,穩定,且速度較快。缺點是上傳圖床最大大小為1M,不過目前我使用圖床的需求也就是寫筆記。Gitee應該也夠用。

步驟一:新建倉庫

按照下圖進行配置,需要注意的是倉庫需要選擇為開源。另外,需要留意倉庫的歸屬和路徑,這個是后續我們需要在PicGo的配置文件中進行配置的。

image-20211014203804605

創建私人令牌

倉庫創建好后,我們要在[個人設置]->[私人令牌]中創建私人令牌(Token),該令牌的權限可以按照下圖進行配置,需要記錄生成的Token。進行到這里,Gitee基本已經配置好了。

image-20211014204152892

安裝並配置PicGo

安裝PicGo

PicGo是一個用於快速上傳圖片並獲取圖片 URL 鏈接的工具,支持多種圖庫。Topora已經原生支持PicGo插件,我們直接在軟件內安裝即可。

image-20211014204815996

這里的下拉選單有PicGo-Core(command line)PicGo(app)Custom Command

image-20211014204928683

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的路徑。

image-20211014210221680

安裝Node.js

我們在命令行窗口中切換到該目錄中,輸入以下命令:

.\picgo.exe install gitee-uploader

需要注意的是,安裝該插件需要使用到npm,因此我們需要安裝node.js環境。否則則會有以下報錯:

image-20211014210510386

我們可以在下載 | Node.js 中文網 (nodejs.cn)中下載node.js,安裝即可。

安裝Gitee插件

安裝完成后,重新執行以下命令,即可安裝成功。

.\picgo.exe install gitee-uploader

image-20211014211133205

配置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
  }
}

配置好后,再點擊驗證圖片上傳,即可查看是否配置成功。

image-20211014212413059

圖片上傳成功,可以在Gitee的倉庫中查看到圖片已經上傳。

image-20211014212302491

上傳圖片

我們新建一個test.md文檔,插入一個圖片,按照之前的配置,該圖片會被保存在./test/asset文件夾中,如下圖:

![image-20211014213031090 - 副本](https://gitee.com/zyfzjuer/figurebed/raw/master/img/image-20211014213031090 - 副本.png)

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

![image-20211014213423941 - 副本](https://gitee.com/zyfzjuer/figurebed/raw/master/img/image-20211014213423941 - 副本.png)

除了這種方法,我們還可以在【格式】>【圖像】中上傳所有本地圖片。如下圖:

image-20211014213524601

需要注意的是,如果圖片所在中存在中文字符,那么直接上傳所有本地圖片就會失敗,需要一個個上傳。這個是比較麻煩的地方

使用堅果雲實現文檔同步

堅果雲的免費賬戶每個月可以有1G的免費上傳流量和3G的免費下載流量

image-20211014213914494

使用堅果雲的方法不再贅述,堅果雲的官方指導手冊說的很清楚。

image-20211014213933195

總結

  • 使用Typora進行Markdown文檔撰寫,美觀!舒適!😍

  • 配置「復制圖片到 ./${filename}.assets 文件夾」,便於文檔遷移。✔

  • 使用PicGo+Gitee,自動同步圖片至圖床!👏

  • 搭配使用堅果雲,實時同步,多終端編輯~😊

參考

Typora使用技巧之插入圖片及圖片上傳 - 知乎 (zhihu.com)


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM