Markdownチートシート
AgendaはMarkdownエディタではありませんが、スタイルを適用するための一部のMarkdown構文を認識します。使用できるMarkdownショートカットは次のとおりです。
段落スタイル
以下のスタイルは、段落全体の外観を変更します。
見出し
行の先頭に1〜6個のハッシュ記号を入力し、その後にスペースを続けます。見出しのレベルはハッシュの数で決まります。 例 ### Sample は第3レベルの見出しになります。
ダッシュリストまたは箇条書きリスト
行を中黒、ハイフン、アスタリスク、またはプラス記号で始めると、ダッシュリスト項目になります。 例 • Sample Item 1 - Sample Item 2 * Sample Item 3 + Sample Item 4 はダッシュリストまたは箇条書きリストの項目になります。
番号付きリスト
行を数字、ピリオド、スペースの順で始めると、番号付きリスト項目になります。 例 \1. Sample Item 1 は番号付きリスト項目になります。
番号付きリストを1以外の番号から始めるには、その番号を使うだけです 例 \3. Sample Item 3 は3から始まる番号付きリスト項目になります。
チェックリスト
行をハイフンで始め、その後に開き角かっこと閉じ角かっこを続けます。2つのかっこの間に「x」を入れると、チェック済みの項目になります。 例 - [ ] Sample はチェックリスト項目になります。
- [x] Sample はチェック済みの項目になります。
ハイフンは省略できるので、2つの角かっこだけでもチェックボックスを作成できます。
整形済みテキスト
コンピュータのコードなど、等幅フォントが適した内容には、整形済みスタイルを適用できます。このスタイルは、行を3つのバッククォートで始めることで適用できます。
例
```sample は sample になります
コード
Agendaはコンピュータコードのシンタックスカラーリングに対応しています。3つのバッククォートの後に言語を追加すると、コードスニペットがどの言語で書かれているかを指定できます。
例
```swift int i = 0; は Swift言語でカラーリングされた int i = 0 になります
対応しているすべての言語パラメータの完全なリストは、highlight.jsプロジェクトが https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md で管理しています。
引用ブロック
行の先頭に1つ以上の>記号を入力し、その後にスペースを続けます。>文字の数によって引用のレベルが決まり、テキストの前に表示される縦線で示されます。
例
> Sample は次のようになります
Sample
インラインスタイル
これらのスタイルは、段落の中でテキストの外観を変えるために使用します。
イタリック
アンダースコアまたはアスタリスクで囲むと、イタリックのスタイルになります。 例 *sample* または *sample* は sample になります
ボールド
二重アンダースコアまたは二重アスタリスクで囲むと、ボールドのスタイルになります。 例 _*sample*_ または **sample** は sample になります
取り消し線
二重チルダで囲むと、取り消し線のスタイルになります。
例
~~sample~~ は sample になります
等幅(モノスペース)
コンピュータのソースコードなど、一部の内容では等幅テキストが望ましい場合があります。テキストのブロックには整形済みテキストの段落スタイルを使うのが最適です。インラインのテキストには、バッククォートで囲むことができます。
例
`sample` は sample になります
ハイライト
二重の等号またはコロンで囲むと、ハイライトのスタイルになります。 例 ==sample== または ::sample:: は sample という語をハイライトします
挿入
一部のスタイルはテキストの意味とは関係なく、タグなどの情報要素を区切るために使われます。これらもMarkdownに似た構文で入力できます。
タグ
タグを入力するには、#記号に続けてタグ名を入力するだけです。タグにスペースを含めることはできません。
例
#giraffes と入力すると、「giraffes」というタグが作成されます。
#を入力すると自動補完のポップオーバーが表示され、目的のタグを見つけやすくなります。
タグはかっこ内にパラメータを含めることもできます。たとえば、#due(12/12/2018)です。 タグのパラメータを最大限に活用する方法について詳しくは、タグ、人物、テキストアクション、リンクの章をご覧ください。
人物タグ
Agendaは、個人(人物)のために予約された2つ目の種類のタグを認識します。友人や同僚を指すために、名前やイニシャルを入力できます。テキストの前に@記号を入力するだけです。
例
@Tom と入力すると、「Tom」という人物のための人物タグが作成されます。
@を入力すると自動補完のポップオーバーが表示され、目的の人物を見つけやすくなります。
絵文字
絵文字を入力するには、:(コロン文字)に続けて絵文字の略称を入力し、最後にもう一度:を入力するだけです。
例
:+1: と入力すると、👍 の絵文字が挿入されます。
:を入力すると自動補完のポップオーバーが表示され、目的の絵文字を見つけやすくなります。
水平線
水平線(横線)を使ってノート内のセクションを視覚的に区切りたい場合は、ダッシュを3つ連続で入力し、その後にスペースを入力します:
例
--- と入力すると水平線が作成されます。
ヒント: Markdownファイルを読み込む場合、同じく3つ連続したダッシュを使って、Agenda内で個別のノートに分割できます: 例 First note
---Second noteこれにより2つの異なるノートが作成されます。1つ目は「First note」という内容、2つ目は「Second note」という内容になります。
表
Agendaではノートに表を挿入できます。行の先頭でパイプ(|)記号を3つ以上連続して入力すると、すばやく作成できます:
例
||| と入力すると表が挿入されます。
リンク
リンクはテキスト内で自動的に認識されますが、Markdown構文で追加することもできます。表示されるテキストを角かっこで囲み、その後にリンクのURLをかっこで囲みます。 例 [Agenda](agenda.com) と入力すると、「Agenda」というテキストにagenda.comへのリンクが付きます。
テキストアクション
厳密には従来のMarkdown構文の一部ではありませんが、Agendaではバックスラッシュ \ 記号を入力してからアクションを続けることで、特定のアクションを実行できます。
たとえば \remindと入力すると、ノートにリマインダーが挿入されます。アクションの一部としてオプションのパラメータを指定できます。たとえば\remind(today at noon)は、今日の正午にリマインダーを設定します。ほかによく使われるアクションには、現在の日付と時刻を挿入する\now、\date、\timeがあります。
すべてのアクションの完全な一覧については、テキストアクションチートシートの章をご覧ください。
アクションはテンプレート内のプレースホルダとしても使用できます。テンプレートの作成と使用の章をご覧ください。
Markdownの解析を防ぐ
Markdownショートカットは非常に便利で素早いのですが、何かをMarkdownとして認識させたくない場合もあります。上記のMarkdownのシーケンスをエスケープするには、まずバックスラッシュ\文字を入力し、続けて通常入力する内容を入力します。スペースを押すと、バックスラッシュ文字は自動的に消え、テキストは入力したとおりに残ります。たとえば、\1. Somethingと入力すると番号付きリストにはならず、1. Somethingというテキストになります。
なお、整形済みテキストの段落スタイルおよび等幅のインラインスタイルが適用されたテキストの中では、Markdownは決して解析されません。