用Markdown作筆記:SublimeText3 + Evernote vs Laverna

以前都把筆記放在Google Drive上面,但是Google Doc這種文書軟體其實不太適合程式類的筆記,於是乎前陣子看到ptt Soft_job版上看到有關作筆記的討論,整理了一下這陣子的使用心得。

關於Markdown

Markdown是一個輕量化的標記語言,簡單的書寫,透過編輯器(最後有列出一些)就可轉換成美美的排版,書寫方式也非常直觀好學,直接閱讀也看得懂。接觸到Markdown是相見恨晚,尤其是在做程式筆記或技術文件上,幾乎可以減少干擾又很流暢的生出一個簡潔美觀的文件。

如何寫Markdown

可以參考 Gitbook裡的中文教學,非常容易上手:Markdown | GitBook 中文解說


Sublime Text3 + Evernote

利用Sublime Text的Evernote套件,同步至evernote帳號

1.安裝Sublime Text3及Package Control

  • 安裝sublime Text 3
  • 安裝Package Control:依照指示,在Sublime Text內按下 ctrl + ` 叫出console後,貼上那一大串的字在輸入框內。

2.安裝markdown套件

在sublime Text裡面按下ctrl + shift + p ,mac使用 command + shift +p 叫出Package Control Command Palette,輸入Package Control: Install Package,輸入你要安裝的套件名稱。以下安裝兩個套件:

  • Markdwon Editing:加速撰寫markdown,比如⌘⌥ V 就是貼上連結,⌘⇧K就是貼圖,裡面都有說明教學。
  • Markdown preview(非必要):安裝完成後使用 ctrl + shift + p ,mac使用 command + shift +p 叫出Package Control Command Palette,輸入Markdown Preview可以看到他列出的一些功能,比如說選擇Markdown Preview:Preview in Browser就可在預設的瀏覽器顯示被html+css消化過的markdown file。
  • Markdown Live Preview(非必要):如果要即時看到html輸出的結果,就安裝這套,alt+m就可以叫出live preview的編輯窗,但是markdown文件一定要儲存成.md檔,否則不能執行,如果我們要使用evernote的話就用不到這個。

3.安裝Evernote套件

同上一步驟,使用Package Control: Install Package,輸入Evernote來安裝套件。第一次使用,請用Command Palette > Evernote: Reconfigure 來設定evernote帳號連結,將NoteStore URL和token輸入到sublime Text裡面。詳細設定和使用方式可參考這裡

4.開始寫筆記

  1. 打開submlime text,Command Palette > Evernote:New empty note

evernote1

  1. 然後就開工,編寫筆記啦。

evernote2

  1. 上傳筆記,Command Palette > Evernote:Send to Evernote as new note
  2. 確認evernote已經產生美美的筆記 (看結果)

evernote3

以下是幾個常用的指令:

  • Command Palette > Evernote: Send to Evernote
  • Command Palette > Evernote: Open Evernote Note
  • Command Palette > Evernote: Search Note
  • Command Palette > Evernote: Update Evernote Note

Laverna

Laverna是一個用javascript撰寫,使用Electron包成的一個開源軟體,我覺得有幾個不錯的優點:

  1. 所見即所得:就跟許多Markdown編輯器一樣,寫起來爽度很高。
  2. 有分類功能,也有tag可以分類筆記。
  3. 支援Dropbox同步,或使用自己的Remote Storage
  4. mac 和 windows可使用

Laverna1

安裝Laverna

laverna.cc裡面可以直接線上使用,但我們為了就地端保存方邊,都使用桌面版的。laverna.cc面提供的是舊版本(0.7.1),在使用上發現這版在同步Dropbox會有無法登入的問題,所以要去他github下載最新版本。

選擇系統下載,如果Mac user請安裝darwin版。
Laverna2

解壓縮後就可以快樂使用囉。

設定Dropbox 同步

以下步驟參考laverna的官方FAQ

  1. 先確認有Dropbox的帳號 https://www.dropbox.com/

  2. 登入Dropbox後,到API設定頁面 https://www.dropbox.com/developers

  3. "My Apps" -> "Create App"

  4. 選擇 "Dropbox API", "Full Dropbox",然後幫你的app取個名字

  5. Redirect URIs 加入兩筆url: "http://localhost:9000/dropbox.html"和 "https://laverna.cc/app/dropbox.html"

  6. Allow implicit grant
    Laverna3

  7. 回到Laverna桌面版,Setting -> Sync

  8. 選擇Dropbox,然後把剛剛app頁面的API KEY輸入上去

Laverna4

如果有多個裝置需要同步存取,比如說我家裡的mac安裝完後,到setting裡面匯出設定,再到辦公室的電腦匯入設定,這樣同步才不會有問題。


心得小評

Evernote + sublime Text方案

  • 跨平台支援度較高
  • 還有額外支援很多功能,比如說擷取網頁、共享
  • 免費版的有空間流量限制,資料放雲端有人不是那麼的安心,萬一人家gg就欲哭無淚
  • 因為我的sublime裝了很多有的沒的套件,很容易與其他的key bindding衝突,也容易誤輸入到其它套件的snippet
  • sublime的live preview套件目前看來支援.md檔,而且一定要就地端存取才給執行,以我這個方案沒辦法使用
  • 因為Medium不支援markdown,在Sublime Text撰寫的檔案必須透過編輯器轉出的結果來貼上

Laverna方案

  • 所寫即得
  • 輕量化
  • 文件都可自行保存
  • 設定同步只支援dropbox,稍微麻煩
  • 雖然可跨mac和windows ,但是開源軟體沒有ios版本,略顯可惜
  • 編寫的markdown文件可以直接貼到我的Ghost blog,而要發佈在Medium的話,可以直接複製轉Laverna換出來的結果貼上,算是符合我目前的筆記及寫作需要。(本篇就是由Laverna編輯後貼上)

補充資料

Markdown編輯器

超級多可以選,整理一些比較常看到的

(補充) 雖然跟markdown無直接相關,但補充一下有一些服務可以直接嵌入UML圖:

  • PlantUML:撰寫Gitbook的時候可加上的UML
  • js-sequence-diagrams:在網站上產出UML後下載,或者是自行嵌入他的js檔
  • yuml:用url就可產生UML圖,然後使用img標籤就可以嵌入圖檔,非常方便! (教學)

參考資料

spreered

掙扎也要前進