本頁內容

下載 PDF

文字動作速查表

Agenda 中的動作讓你能輸入簡短的指令，這些指令在完成時會被動態轉換並展開為純文字，或是叫用某個動作，例如把筆記標示為「在議程上」。你可以把它想成觸發某個動作的快速方式，例如輸入 \remind 來插入提醒事項，或輸入 \date 來插入目前日期。

動作以反斜線字元（\）作為前綴，它會叫出一個自動完成選單，顯示可用的動作，你還可以輸入想使用的動作的前幾個字元來進一步篩選。

提示： 在沒有實體鍵盤的 iPhone 和 iPad 上，輸入反斜線字元可能有點麻煩。你可以改為直接點按並按住鍵盤上方的加號按鈕來觸發動作選單。很方便！

同樣地，在某些鍵盤上，例如中文或日文鍵盤，很難輸入反斜線字元，因此凡是顯示反斜線字元的地方，你也可以使用兩個反引號（``）或兩個間隔號字元（··）。

其中許多動作可以在括號內帶入所謂的參數（類似於你可以為標籤加上數值參數的做法，詳見 標籤、人物、文字動作與連結 一章），以進一步調整這些動作的行為。舉例來說，\date(in: 2 weeks) 會插入從現在起兩週後的日期，而非目前日期。

標示為預設的參數，會在未提供任何參數時被視為預設參數。舉例來說，\tag(important) 與 \tag(name: important) 被視為相同。

大多數動作在範本中同樣有效，此外範本還支援一些僅在範本中有效的動作，如需這些動作的總覽，請參閱 建立與使用範本 一章。

以下你會找到 Agenda 目前支援的動作完整總覽。

插入

`\tag`

在筆記文字中插入一個標籤代符
同義詞：#、\insert-tag

參數

name －標籤的名稱－ 預設、必須的
color －標籤顏色的名稱或十六進位值－ Premium 功能
value、text、string －選用的文字值－ 第二預設
day、on、after、before、until、from、in －選用的日子值
date、at －選用的日期值
int、integer、number、level －選用的整數值
float、double －選用的浮點數值

範例

\tag(name: important) －建立標籤 #important，等同於 \tag(important)
\tag(important, color: blue) －建立藍色的標籤 #important
\tag(important, color: #333) －建立十六進位顏色為 #333 的標籤 #important
\tag(priority, value: high) －建立標籤 #priority(high)，等同於 \tag(priority, high)
\tag(due, day: tomorrow) －建立標籤 #due(6 April 2022)
\tag(due, in: 3 weeks) －建立標籤 #due(26 April 2022)
\tag(deadline, at: 17 oct 2022 13pm) －建立標籤 #deadline(17 Oct 2022 at 13.00)
\tag(priority, int: 1, color: red) －建立紅色的標籤 #priority(1)
\tag(version, float: 2.1) －建立標籤 #version(2.1)

`\person`

在筆記文字中插入一個人物代符
同義詞：@、\insert-person、contact

參數

name、alias、nickname －人物的姓名－ 預設、必須的

範例

\person(name: Tom G) －建立人物 @(Tom G)，等同於 \person(Tom G)

`\reminder`

在「提醒事項」應用程式中插入並排定一則提醒事項
同義詞：\remind、\insert-reminder

參數

none －插入一個未排定時間的佔位提醒事項
due-date －代表未來某個日期的自然語言字串－預設
title －要排定的提醒事項標題
list －要在「提醒事項」應用程式中排定該提醒事項的列表
all-day －將該提醒事項排定為全天提醒事項

範例

\reminder －建立一個未排定時間的提醒事項並開啟編輯彈出視窗
\reminder(today) －為今天 30 分鐘後排定一則提醒事項
\reminder(today at 6pm) －為今天 6 點排定一則提醒事項
\reminder(tomorrow evening) －為明天 6 點排定一則提醒事項
\reminder(in 3 weeks) －排定一則從現在起 21 天後的提醒事項
\reminder(25 dec 2020, at 8pm)` －為 2020 年 12 月 25 日 8 點排定一則提醒事項
\reminder(today at 6pm, list: important) －在提醒事項列表「important」中，為今天 6 點排定一則提醒事項
\reminder(all-day: tomorrow) －為明天排定一則全天提醒事項

`\star`

在筆記文字中目前段落的結尾插入一個星號
同義詞：#star、\insert-star、\flag

參數

none －在段落結尾插入一個星號

範例

\star －在段落結尾建立一個星號，等同於 #star

`\date`

將目前日期插入筆記標題或內文
同義詞：\insert-date

參數

none －以預設格式插入目前日期
full、long、medium、short －以指定形式呈現的標準日期格式－預設
format －自訂格式的日期，請參閱下方的提示和注意事項
locale －用於格式化日期的地區設定
timezone －用於格式化日期的時區
in、for、offset －今天以外的其他日期
default-format －將 \date 的預設格式設為所提供的自訂格式

範例

\date － 22-07-20
\date(full) － Wednesday, July 22, 2020
\date(short) － 7/22/20
\date(format: dd-MM-yy) － 22-07-20
\date(full, locale: no) － onsdag 22. juli 2020
\date(for: tomorrow) － 23-07-20
\date(in: 2 days) － 24-07-20
\date(offset: 3 weeks) － 12-08-20
\date(default-format: dd-MM-yy) － 22-07-20（並將此格式設為預設）

提示：如需支援的日期格式完整總覽，請參閱 http://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns。舉例來說：\date(EEE\, MMM d\, ''yy) 會產生 Wed, Jul 22, ‘20。請注意模式中的逗號必須用斜線跳脫，否則會被視為下一個參數。冒號也是如此，例如這個範例：\time(format: HH\:MM)，結果為 18:34。

重要：當你以參數提供某個格式時，無論是自訂格式或 full、long、medium、short，它也會成為你省略參數、只輸入 \date 時的預設格式。若要將格式還原為 medium，你可以輸入一次 \date(default)。

`\time`

將目前時間插入筆記標題或內文

參數

none －以預設格式插入目前時間
full、long、medium、short －以指定形式呈現的標準時間格式－預設
format －自訂格式的時間，請參閱上方的提示和注意事項
locale －用於格式化時間的地區設定
timezone －用於格式化時間的時區
default-format －將 \time 的預設格式設為所提供的自訂格式

範例

\time － 12:27
\time(full) － 12:27:15 PM Western European Summer Time
\time(short) － 12:27
\time(format: HH\\:mm\\:ss) － 12:27:33
\time(medium, locale: en_US_POSIX) － 12:27:15 PM

提示： 如需地區設定的完整列表，請參閱 https://gist.github.com/jacobbubu/1836273；如需時區識別碼列表，請參閱 https://apphelp.readdle.com/calendars/index.php?pg=kb.page&id=588

`\now`

將目前日期和時間插入筆記標題或內文
同義詞：\timestamp

參數

none －以預設格式插入目前日期和時間
full、long、medium、short －以指定形式呈現的標準時間格式－預設
format －自訂格式的時間，請參閱上方的提示和注意事項
locale －用於格式化日期和時間的地區設定
timezone －用於格式化日期和時間的時區
default-format －將 \now 的預設格式設為所提供的自訂格式

範例

\now － 22-07-20 02:30
\now(full) － Wednesday, July 22, 2020 at 2:29:53 AM Western European Summer Time
\now(short) － 7/22/20, 2:30 AM
\now(format: dd-MM-yy HH\\:mm\\:ss) － 22-07-20 02:30:30
\now(medium, locale: en_US_POSIX) － Jul 22, 2020 at 2:31:03 AM

`\expression`

將某個運算式的計算結果插入筆記文字中
同義詞：\formula、\insert-expression、\math

參數

math －要計算的數學運算式－預設
sum、add、total －要加總的逗號分隔數值列表
count －要計數的逗號分隔數值列表
min、minimum －要從中挑選最小值的逗號分隔數值列表
max、maximum －要從中挑選最大值的逗號分隔數值列表
average、avg －要取平均值的逗號分隔數值列表
median、med －要取中位數的逗號分隔數值列表
stddev、standard-deviation、stdev －要取標準差的逗號分隔數值列表
sqrt、square-root －要取平方根的數值
log、lg、logarithm －要取對數的數值
ln、natural-logarithm －要取自然對數的數值
random、rdm －介於 0 與所提供數字之間的隨機值

範例

\expression(5 * 8) － 40
\expression(sum: 2, 5, 7) － 14
\expression(count: 2, 5, 7) － 3
\expression(min: 2, 5, 7) － 2
\expression(max: 2, 5, 7) － 7
\expression(average: 2, 5, 7) － 4.666…
\expression(median: 2, 5, 7) － 5
\expression(stddev: 2, 5, 7) － 2.0548…
\expression(sqrt: 9) － 3
\expression(log: 9) － 0.9542…
\expression(ln: 9) － 2.197…
\expression(random: 9) － 7
\expression(random: 1.0) － 0.598

`\horizontal-rule`

在筆記文字中插入一條水平分隔線（分隔用的線條）
同義詞：\rule、\insert-horizontal-rule、\hr

範例

\rule －插入一條水平分隔線

`\table`

在筆記文字中插入一個表格
同義詞：\insert-table、\tb

參數

none －插入標準的 2x2 表格
size、dimensions －以「欄 x 列」格式表示的目標表格大小－預設
columns、c －表格應有的欄數
rows、r －表格應有的列數

範例

\table －插入標準的 2x2 表格
\table(3x4) －插入一個 3 欄 4 列的表格
\table(columns: 4) －插入一個 4 欄 2 列的表格
\table(rows: 4) －插入一個 2 欄 4 列的表格
\table(r: 3, c: 4) －插入一個 4 欄 3 列的表格

`\link`

在筆記文字中插入一個網頁連結，或連到某個專案或筆記的連結
同義詞：\url、\insert-link、\ref、\href、[[
簡寫：\project、\note

參數

url －要插入的連結網址預設
description、dimensions －該連結的描述文字－ 第二預設
project、project-title、to －該連結應指向的專案名稱
note、note-title －該連結應指向的筆記標題

範例

\link(apple.com, apple website) －插入文字 apple website，並附上連到 apple.com 的連結
\link(url: http://microsoft.com, description: microsoft) －插入文字 microsoft，並附上連到 microsoft.com 的連結
\link(project: Developing Yak App, description: YakApp) －插入文字 YakApp，並附上連到名為 Developing Yak App 專案的連結
\link(note-title: Meeting the developers) －插入一個連到標題為 Meeting the developers 之筆記的連結

提示： 除了使用 \link 之外，你也可以使用 [[ 這個快速輸入方式，插入連到另一個專案或筆記的連結。你甚至可以輸入 [[recent 來查看所有最近編輯過、可供連結的筆記列表。

`\summary`

在筆記文字中選取範圍或游標所在的位置插入一份摘要
同義詞：\summarize、\insert-summary

參數

none －插入所有未勾選列表項目的摘要
list －依據以下其中一項條件插入列表項目的摘要： - 預設
- checked －所有已勾選的項目
- unchecked －所有未勾選的列表項目
- starred －所有以星號標記的段落
- tagged －所有含有標籤的段落
- assigned －所有含有人物代符的段落
tag －要摘要的標籤名稱
person －要摘要的人物姓名

範例

\summary －插入筆記中所有未勾選列表項目的摘要
\summary(list: checked) －插入筆記中所有已勾選列表項目的摘要
\summary(starred) －插入所有以星號標記段落的摘要
\summary(tag: urgent) －插入所有帶有名為 urgent 標籤之段落的摘要
\summary(tag: priority[1]) －插入所有帶有名為 priority、值為 1 標籤之段落的摘要（請注意這裡使用方括號而非圓括號）
\summary(person: tom) －插入所有帶有名為 tom 人物之段落的摘要

`\attachment`

在筆記文字中插入一個附件，會觸發開啟檔案對話框以挑選要附加的檔案
同義詞：\attach、\file、\insert-attachment

參數

none －開啟檔案挑選器以選取要插入的附件
description、title、name －要作為所匯入附件檔案描述的文字－預設

範例

\attach －開啟檔案挑選器
\attach(My File) －開啟檔案挑選器，並在匯入後以 My File 作為該附件的描述

`\drawing`

在筆記文字中插入一幅繪圖，並顯示繪圖畫布－ 僅限 iOS 和 iPadOS
同義詞：\draw、\insert-drawing

參數

none －顯示一塊新的繪圖畫布
description、title、name －要作為該繪圖描述的文字－預設

範例

\draw －開啟一塊新的繪圖畫布
\draw(My Drawing) －開啟一塊新的繪圖畫布，並以 My Drawing 作為該繪圖的描述

`\template`

在插入點處，或取代選取範圍，將某個範本的內容插入筆記文字中
同義詞：\insert-template

參數

name －要使用的範本名稱－ 預設、必須的
input －要用來取代範本中 input 佔位符的文字

範例

\template(Book Review) －插入 Book Review 範本的內容
\template(Book Review, input: The title of this book) －插入 Book Review 範本的內容，並以文字 The title of this book 取代 \input 佔位符。

段落樣式

`\body`

將段落樣式重置回純內文文字
同義詞：\p

範例

\body －重置所有格式，讓你輸入時段落樣式設為內文文字

`\heading`

將段落樣式設為標題
簡寫：\heading1、\h1、\heading2、\h2、subheading、\heading3、\h3、\heading4、\h4

參數

level －要使用的標題層級－預設

範例

\heading －將樣式改為「標題」，等同於 \heading1 和 \h1
\heading(level: 2) －將樣式改為副標題，等同於 \heading2、\h2 和 \subheading
\h3 －將樣式改為次標題

`\preformatted`

將段落樣式設回預先格式化文字
同義詞：\pre

範例

\pre －將樣式改為預先格式化文字，等同於 \preformatted

`\list`

將段落樣式設為破折號或項目符號（視你的偏好而定）的無序列表
同義詞：\ul、\dashed、\bulleted

範例

\list －將樣式改為破折號列表，等同於 \ul，或輸入一個破折號、星號或項目符號後接一個空格

`\numbered`

將段落樣式設為編號（有序）列表
同義詞：\ol

參數

none －將樣式設為從 1 開始的編號列表
start、from －列表的起始數字

範例

\numbered －將樣式改為從 1 開始的編號列表，等同於輸入 1. 後接一個空格
\numbered(start: 5) －將樣式改為從 5 開始的編號列表，等同於輸入 5. 後接一個空格

`\checklist`

將段落樣式設為檢查列表
同義詞：\cl

範例

\checklist －將樣式改為檢查列表，等同於 \cl

列表動作

`\check`

勾選目前這一行的檢查列表項目

參數

none －勾選目前這一行的檢查列表項目
all －勾選目前這一行所屬列表中的所有檢查列表項目

範例

\check －勾選目前這一行的檢查列表項目
\check(all) －勾選該列表中的所有檢查列表項目

`\check-all`

勾選目前這一行所屬列表中的所有檢查列表項目
同義詞：\all

範例

\all －勾選目前列表中的所有檢查列表項目

`\uncheck`

取消勾選目前這一行的檢查列表項目

參數

none －取消勾選目前這一行的檢查列表項目
all －取消勾選目前這一行所屬列表中的所有檢查列表項目

範例

\uncheck －取消勾選目前這一行的檢查列表項目
\uncheck(all) －取消勾選該列表中的所有檢查列表項目

`\reset`

取消勾選目前這一行所屬列表中的所有檢查列表項目

範例

\reset －取消勾選目前列表中的所有檢查列表項目

`\sort`

排序目前這一行所屬的檢查列表，讓已勾選的列表項目被移到最下方

範例

\sort －將目前列表中已勾選的項目移到最下方

格式

`\bold`

切換粗體格式
同義詞：\b

範例

\b －切換粗體格式，等同於 \bold

`\italic`

切換斜體格式
同義詞：\i

範例

\i －切換斜體格式，等同於 \italic

`\underline`

切換底線格式
同義詞：\u

範例

\u －切換底線格式，等同於 \underline

`\fixed-width`

切換固定寬度格式
同義詞：\fixed

範例

\fixed －切換固定寬度格式，等同於 \fixed-width

`\strikethrough`

切換刪除線格式
同義詞：\strike

範例

\strikethrough －切換刪除線格式，等同於 \strike

`\superscript`

切換上標格式
同義詞：\sup

範例

\sup －切換上標格式，等同於 \superscript

`\subscript`

切換下標格式
同義詞：\sub

範例

\sub －切換下標格式，等同於 \subscript

`\color`

切換文字顏色格式
同義詞：\text-color

參數

color －要使用的顏色名稱－ 預設、必須的

範例

\text-color(color: green) －切換為綠色文字顏色，等同於 \color(green)
\color(#333) －切換為十六進位顏色 #333 的文字顏色

`\highlight`

切換文字螢光標示格式

參數

color －要使用的顏色名稱－ 預設、必須的

範例

\highlight(color: blue) －切換為藍色文字螢光標示，等同於 \highlight(blue)
\highlight(#333) －切換為十六進位顏色 #333 的文字螢光標示

`\clear`

移除所有格式，回復為純文字
同義詞：\c

範例

\clear －重置所有行內樣式格式

筆記動作

`\on-the-agenda`

將筆記標示為「在議程上」，若目前已被標示則取消標示
同義詞：\ota、\ontheagenda、\agenda

範例

\ota －將筆記標示為「在議程上」，等同於 \on-the-agenda

`\done`

將筆記標示為已完成

範例

\done －將筆記標示為已完成

`\undone`

取消將筆記標示為已完成

範例

\undone －取消將筆記標示為已完成

`\pin`

將筆記釘選到專案的最上方

範例

\pin －釘選該筆記

`\footnote`

將筆記變成釘選在專案最下方的置底筆記

範例

\footnote －將該筆記變成置底筆記

`\unpin`

讓已釘選的筆記或置底筆記回復為一般筆記

範例

\unpin －將已釘選的筆記或置底筆記變回一般筆記

`\assign-date`

將所提供的日期指定給目前的筆記
同義詞：\assign
簡寫：\today、\tomorrow、\yesterday、\monday、\tuesday、\wednesday、\thursday、\friday、\saturday、\sunday

參數

day、on、after、before、until、from、in －應被指定日子的自然語言表達－預設
date、at －應被指定日期的自然語言表達

範例

\assign(17 oct 2022) －將該筆記指定到 2022 年 10 月 17 日
\assign(in: 3 weeks) －將該筆記指定到今天之後 3 週
\assign(tomorrow) －將該筆記指定到明天
\assign(next Wednesday) －將該筆記指定到下週三
\today －將該筆記指定到今天
\friday －將該筆記指定到接下來的星期五

`\link-event`

將所提供的行程連結到目前的筆記
同義詞：\event

參數

day、on、after、before、until、from、in －應搜尋行程之日子的自然語言表達－預設
date、at －應搜尋行程之日期的自然語言表達
calendar －搜尋應限定的行事曆

範例

\event(17 oct 2022) －顯示 10 月 17 日可供該筆記連結的行事曆行程
\event(calendar: Work, 17 oct 2022) －顯示 10 月 17 日來自 Work 行事曆、可供該筆記連結的行程

`\new`

Agenda 15 新增

在目前筆記之後新增一則筆記

參數

none －在目前筆記之後新增一則筆記
title －將被建立筆記的標題－預設
template －新筆記要使用的範本

範例

\new －在你目前所在的筆記之後建立一則新筆記
\new(Part Two) －建立一則標題為 Part Two 的新筆記
\new(title: 15 Dec, template: Daily Meeting) －使用 Daily Meeting 範本建立一則標題為 15 Dec 的新筆記。

`\split`

在插入點分割目前的筆記

參數

none －在插入點分割目前的筆記－預設
title －將從目前筆記分割出來的那則筆記標題

範例

\split －在插入點分割目前的筆記
\split(title: Part Two) －在插入點把目前的筆記分割成一則標題為 Part Two 的新筆記

`\duplicate`

複製目前的筆記

參數

none －複製目前的筆記－預設
title －複本筆記的標題

範例

\duplicate －在插入點分割目前的筆記，等同於 \new
\duplicate(title: Part Two) －建立一份標題為 Part Two 的目前筆記複本

`\move`

將目前的筆記移到不同的專案

參數

project、project-title、to －該筆記應移往的專案標題－ 預設、必須的

範例

\move(to: Developing Yak App) －將目前的筆記移到 Developing Yak App 專案

`\print`

列印目前的筆記

範例

\print －列印該筆記

跳脫

動作

如果你不希望某個動作被執行，而是要它以文字的形式保留，你可以在該動作前加上一個額外的反斜線字元，像這樣：\\tag(name: Alex)。該動作就不會導致建立標籤 Alex，而是保留為 \tag(name: Alex)。或者，你也可以把段落樣式改為「預先格式化」，或把行內樣式改為固定寬度，以防止動作被執行。

參數

冒號和逗號在動作的參數列表中有特殊意義，如果某個參數的引數需要包含這些字元之一，你可以使用反斜線字元來跳脫它們。

舉例來說，若不跳脫，\date(format: YYYY, dd-MM) 會被錯誤剖析，只顯示年份 2022；你可以改用 \date(format: YYYY\, dd-MM) 來顯示 2022, 07-04

同樣地，若不跳脫，\split(Newsflash: ABC) 不會被正確剖析，而 \split(Newsflash\: ABC) 則可以。

在地化

請注意，所有動作和參數都應依應用程式的語言適當在地化。在這種情況下，你可以使用上述的英文形式，或翻譯後的形式。請注意，雖然這些動作可能含有重音符號及／或大寫字母，但你不需要輸入這些，舉例來說，在法文版的 Agenda 中，你可以輸入以下任何一種來取得編號列表：

\numérotée
\numerotee
\Numérotée
\numbered

其他語言版本: English Español Français Deutsch 简体中文 Nederlands Italiano Afrikaans Русский Polski Português (Brasil) Português (Portugal) Čeština Slovenčina 한국어 日本語 Svenska Dansk Norsk