Jrnl 是用Python編寫的命令行筆記應用程序，用起來非常簡單方便，特別適合需要快速記錄文本信息的同學。

您可以使用它輕松創建，搜索和查看所有的筆記。筆記以人類可讀的純文本存儲，當然也可以使用 AES加密進行加密。

1.準備

開始之前，你要確保Python和pip已經成功安裝在電腦上，如果沒有，可以訪問這篇文章：超詳細Python安裝指南 進行安裝。

如果你用Python的目的是數據分析，可以直接安裝Anaconda：Python數據分析與挖掘好幫手—Anaconda，它內置了Python和pip.

此外，推薦大家用VSCode編輯器，它有許多的優點：Python 編程的最好搭檔—VSCode 詳細指南。

請選擇以下任一種方式輸入命令安裝依賴 ：

1. Windows 環境 打開 Cmd (開始-運行-CMD)。
2. MacOS 環境 打開 Terminal (command+空格輸入Terminal)。
3. 如果你用的是 VSCode編輯器 或 Pycharm，可以直接使用界面下方的Terminal.

pip install jrnl

2.快速上手

要創建一個新的筆記，你只需要在終端這樣輸入：

jrnl now: 第一次使用. 我擦，這玩意兒真的好用嗎？

jrnl 是筆記開始的標志。now: 的標記會記錄一個當前時間的時間戳，后接的第一句話到句號( . )為止是筆記的標題。句號后續的所有內容都是該筆記的內容。

第一次使用的時候，會讓你指定筆記記錄的位置和是否需要加密：

Path to your journal file (leave blank for C:Users83493.localsharejrnljournal.txt):
Do you want to encrypt your journal? You can always change this later [y/N] n

一般默認即可，除非你需要做特殊的處理。

如果要查看剛剛編寫的記錄，可以這樣查看到今日為止的所有筆記：

jrnl -to today

結果如下：

或者：

jrnl -n 1

-n 后接的是數字，能夠查看最近n條筆記，比如查看最近一條筆記：

不錯，要記點簡單的東西的時候甚至不需要開文檔編輯器，直接終端用jrnl記錄即可。

下面是更多功能的說明。

3.基本使用

如果你在輸入 jrnl 命令時后面不接時間，jrnl 會默認使用當前時間插入到筆記中。

不過有時候我們想記的筆記或者日記是多日之前甚至是幾個月之前的，這時候jrnl也提供了許多強大的時間格式：

3.1 筆記的時間

jrnl 支持的時間格式如下：

• at 6am
• yesterday
• last monday
• sunday at noon
• 2 march 2012
• 7 apr
• 5/20/1998 at 23:42
• 2020-05-22T15:55-04:00

比如：

jrnl 2021-02-01: 2月初. 2月的第一天，祝大家2月萬事如意，快快樂樂。

然后查看到今日為止的所有筆記如下：

PS G:push > jrnl -to today
2021-02-01 09:00 Called in sick.
| Used the time to clean and spent 4h on writing my book.

2021-02-01 09:00 2月初.
| 2月的第一天，祝大家2月萬事如意，快快樂樂。

2021-02-02 00:21 第一次使用.
| 我擦，這玩意兒真的好用嗎？

當然，不使用冒號也是可以記筆記的：

PS G:push > jrnl 不用冒號也能記筆記嗎？
[Entry added to default journal]

3.2 標簽功能

jrnl 支持標簽功能。默認標記符號為@（不用#號是因為它是保留字符）。

要使用標簽，請在所需標記的文字前面加上@符號：

jrnl Had a wonderful day at the @beach with @Tom and @Anna.

盡管可以在標記條目時使用大寫字母，但按標記搜索時不區分大小寫。

條目中可以使用多個標簽沒有限制。

3.3 重點筆記

要將筆記標記為重點項，只需使用星號（*）對它進行“星標” ：

jrnl last sunday *: Best day of my life.

如果你不想添加日期，則以下選項是等效的（確保*號后面沒有空格）：

jrnl *: Best day of my life.
jrnl *Best day of my life.
jrnl Best day of my life.*

3.4 查看和搜索

要查看到今天為止的所有條目，請輸入：

jrnl -to today

jrnl提供了幾個過濾命令，以單破折號（-）開頭，可讓您更方便地進行查找。例如 -n：

jrnl -n 10

列出最近的十個條目。更簡潔的寫法是 jrnl -10 ，這兩者效果一致。

如果要查看從去年年初到今年三月底之前編寫的所有條目，請輸入:

jrnl -from "last year" -to march

使用多個單詞的過濾條件需要使用引號（""）括起來。

要查看特定日期的條目，請使用 -on：

jrnl -on yesterday

文字搜尋

**-contains **命令顯示包含該關鍵詞的所有筆記，--edit 允許你編輯這些筆記。

jrnl -contains "dogs" --edit

不過編輯筆記之前，jrnl會提示你配置一個默認的編輯器（因為編輯功能需要打開編輯器）：

按標簽過濾

您可以按標簽過濾筆記。例如：

jrnl @pinkie @WorldDomination

顯示@pinkie或@WorldDomination 的所有筆記。標簽過濾器可以與其他過濾器結合使用：

jrnl -n 5 @pinkie -and @WorldDomination

顯示包含 @pinkie 和 @worldDomination 的最近五個筆記。

要查看筆記中所有的標簽，請輸入：

jrnl --tags

查看所有重點筆記 :

jrnl -starred

3.5 刪除筆記

刪除筆記非常簡單，相當于搜索后加 --delete 參數進行刪除。

PS G:push > jrnl -contains "2月" --delete
Delete entry '2021-02-01 09:00 2月初.2月的第一天，祝大家2月萬事如意，快快樂樂。'? [y/N] y