Obsidian Callouts（コールアウト）：構文、種類、例、カスタムCSS完全ガイド

ObsidianのCallout（コールアウト／強調ブロック）を使用すると、引用ブロックベースのシンプルな構文を使って、ノート内の特定のコンテンツを強調、グループ化、あるいは非表示にすることができます。試験のポイントに注目を集めたり、折りたたみ可能なタスクリストを作成したり、原稿から著者メモを切り離したりする場合でも、コールアウトは執筆フローを妨げることなく情報を視覚的に整理する柔軟な手段を提供します。

クイック回答：Obsidianコールアウトの作り方

はい。Obsidianのコールアウトは、1行目に > [!type] を使用するスタイリッシュな引用ブロックです。本ガイドでは、構文、コピー＆ペースト可能な例、組み込みタイプ、折りたたみやネストのルール、さらにカスタムCSSの一般的なトラブルシューティング手順を解説します。最新のタイプ一覧やエディタコマンドについては 公式コールアウトヘルプ を確認してください。

コールアウトを作成する基本構文は以下の通りです：

> [!note] これはコールアウトです。

• 引用ブロックの1行目に > [!type] を使用します。

• note の部分を tip 、 warning 、 question などの他のタイプに置き換えます。

• Enterキーを押して > を続けて入力し、複数行のコンテンツを追加します。

• ライブプレビューモードでは、コマンドパレットを開いて Insert callout を選択すると、デフォルトのコールアウトブロックを即座に挿入できます。既存のテキストを選択した状態で同じコマンドを実行すると、選択範囲をコールアウトで囲むことができます。

Obsidian Calloutsとは何か？

コールアウトとは、Obsidianが色、アイコン、およびオプションの折りたたみ動作を適用してレンダーするスタイル付きの引用ブロックです。2022年半ばに導入され、ノートを視覚的に整理するためのコア機能となっています。

Obsidianは [!type] で始まる引用ブロックを検出すると、それを特別に解析し、通常の引用ブロックではなく強調コールアウトボックスとして表示します。コールアウトの本文内では、標準のMarkdown構文、ウィキリンク、埋め込み、タスク、コードブロック、内部リンクをすべて使用できます。

視覚的には、コールアウトは着色されたサイドバー、アイコン（ヒント用の電球や警告用の感嘆符など）、オプションのタイトルバー、およびその下の本文テキストで表示されます。

主な用途：

• 会議メモの冒頭での要点のまとめ

• 勉強ノートにおける試験重要ポイントの強調

• 読書メモにおけるネタバレ防止ボックスの作成

コールアウトはこのデザインで表示されるのはObsidian内部のみである点に注意してください。プレーンなMarkdownビューアやGitHub上では、通常のネストされた引用ブロックとして表示されます（内容は問題なく読めますが、スタイルが適用されません）。

コールアウトの構文と設定

本セクションでは、タイプ、タイトル、折りたたみ、本文コンテンツなどのすべての構文要素を解説します。

基本構造は以下の通りです：

> [!note] タイトルテキスト
> 本文のコンテンツがここに入ります。
> - 箇条書きも使用可能です。

1行目には3つの要素が含まれます：

• 角カッコ内の タイプ識別子 ： [!note] , [!warning] , [!tip]

• オプションの折りたたみマーク ：タイプの直後につける + または - （例： [!tip]- ）

• タイプの後に書く オプションのカスタムタイトル （例： [!tip] 試験のヒント ）

本文行は通常の引用ブロックと同様に > で始まり、箇条書き、コードブロック、画像、タスクチェックボックスを含めることができます。

タイプキーワードは大文字と小文字を区別しません。組み込みコールアウトでは [!NOTE] 、 [!Note] 、 [!note] はすべて同様に動作します。

コールアウトタイトルの変更

デフォルトでは、Obsidianはタイプ名をタイトルとして使用します（例：「Note」や「Warning」）。

デフォルトタイトルを上書きするには：

> [!warning] デプロイ前に必ずお読みください

以下の2つのアプローチを比較してください：

• > [!tip] はデフォルトの見出し「Tip」で表示されます。

• > [!tip] より高速なワークフロー は代わりに「より高速なワークフロー」と表示されます。

タイトルのみのコールアウトも可能です。後続の本文行を置かずに > [!info] システム要件 のように1行だけ記述します。

タイトルには絵文字、ウィキリンク、太字などのフォーマットを含めることができます。

折りたたみ可能（Collapsible）なコールアウト

タイプの直後にプラス記号またはマイナス記号を追加することで、コールアウトを折りたたみ可能にするかどうかを制御できます：

• > [!note]+ デフォルトで常に展開状態

• > [!note]- デフォルトで折りたたみ状態

どちらのマークをつけてもコールアウトは折りたたみ可能になります。記号の違いは、初期状態が開いているか閉じているかを決定します。

折りたたみコールアウトの実用的な用途：

• 勉強ノートで詳細な解答プロセスを隠す

• 長いチェックリストを [!todo]- 見出しの下に折りたたむ

• 読書メモでネタバレを隠す

閲覧モードおよびライブプレビューモードでは、ユーザーは三角アイコンをクリックして展開・折りたたみを切り替えます。ソースモードでは、折りたたみマークは生のMarkdownとして表示されます。

ネストされたコールアウト

親コールアウトの本文内に別のコールアウトブロックを配置することで、コールアウトをネスト（入れ子）にできます。

内側のコールアウト行は、ネストレベルごとに追加の > を使用します：

> [!warning] 潜在的な問題
>> [!tip] 回避策はこちら

これにより、ネストされたヒントを含む警告コールアウトが作成されます。別の例として、ネストされた [!example] 回答を含む [!question] があります。

視認性を保つためネストの深さは制限してください。通常は2レベルで十分です。

Obsidianでサポートされているコールアウトタイプ

Obsidianには組み込みタイプが用意されており、それぞれ色とアイコンにマッピングされています。サポートされていないタイプは note のスタイルにフォールバックします。

主なデフォルトタイプとエイリアス：

• note ：一般的な情報

• abstract / summary / tldr ：要約・サマリー

• info ：補足文脈

• todo ：タスク・アクションアイテム

• tip / hint / important ：アドバイス・要点

• success / check / done ：完了項目

• question / help / faq ：質問・FAQ

• warning / caution / attention ：潜在的な問題・警告

• failure / fail / missing ：欠落・失敗情報

• danger / error ：深刻なエラー

• bug ：バグ情報

• example ：コード例・概念例

• quote / cite ：強調引用

テーマによってはこれらのタイプを再スタイルしている場合があるため、同じ [!warning] でもテーマによって見た目が異なることがあります。

ライブプレビューモードでは、コールアウトのガター部を右クリックしてコンテキストメニューからタイプを変更することも可能です。

[!idea] などの未定義タイプは見た目上 note として表示されますが、CSSでのターゲット設定には引き続き使用可能です。

どのコールアウトを使うべきか？

タイプは単なる色ではなく「シグナル」を制御します。後でノートを見返したときに何をすべきか直感的にわかるルールを決めましょう：

シグナルしたい内容	おすすめの開始タイプ	有用なパターン
文脈や定義	info または abstract	根拠となる主張のすぐ隣に説明を配置する。
次のアクション	todo	チェックリストをプロジェクトや会議の文脈の近くに配置する。
決定事項やリスク	question , warning , またはカスタム	未解決のポイントを文章に埋もれさせずに可視化する。
たまにしか参照しない詳細	折りたたみ example または note	- を使って補足詳細をデフォルトで折りたたんでおく。
完了した成果	success または done	単なる前向きな文章ではなく、明確な成果に対して使用する。

生産性Vaultのための実用的な最小構成は、アクション用に todo 、ブロッカー用に warning 、未決事項用に question 、振り返り用に summary です。

Vaultでの実践的なコールアウト活用法

実際のワークフローにおける活用例：

• 学習・テスト対策：試験のヒントに [!tip] 、解答を折りたたんだ練習問題に [!question]- 、講義メモの冒頭に [!summary]

• ソフトウェア開発：破壊的コマンドの周囲に [!warning] 、既知の不具合に [!bug] 、API使用コード例に [!example]

• プロジェクト・タスク管理：マイルストーンごとにグループ化した [!todo]+ にチェックリストを保存し、完了時に [!success] へ変更

• 長文執筆： [!note]- やカスタムタイプで著者メモを分離し、下書き内で伏線やヒントを [!clue] としてマーク

• 個人ナレッジベース：重要ファクトに [!info] 、引用に [!quote] 、重大警告に [!danger]

コールアウトが組み込まれた Obsidianテンプレート例 も参考にしてください。会議ワークフローについては Obsidian会議テンプレートガイド を参照してください。

タスクとチェックリストのためのコールアウト

コールアウト内のタスクは通常のObsidianタスクとして動作し、グローバルタスク検索にもヒットします。

[!todo] コールアウトは関連するチェックボックスをまとめます：

> [!todo]+ リリース1.2 チェックリスト
> - [ ] 2025-04-01リリース用CHANGELOGの更新
> - [ ] 回帰テストの実行

タイプを todo から success に変更することで、ブロック全体の完了を視覚的に表現できます。

パブリッシングワークフローにおけるコールアウト

コールアウトは内部編集用のツールであり、書籍、PDF、ブログ記事などの最終出力には含めないケースが一般的です。

Longformなどのプラグインを使用すると、コンパイル前にコールアウトマークアップを削除する前処理ステップを追加できます。スクリプトが > [! で始まる行をスキャンし、本文を維持または破棄しながらラッパーを削除します。

CSSによるコールアウトのカスタマイズ

Obsidianは data-callout 属性を介してコールアウトを公開しているため、カスタムCSSで独自のタイプを定義できます。

手順：

1. idea などのカスタムタイプ識別子を決定

2. ノートで使用： > [!idea] 新製品のコンセプト

3. CSSで .callout[data-callout="idea"] をターゲットにし、固有の色やアイコンを設定。

ObsidianはLucideアイコンを使用します。対応するCSS APIは --callout-color と --callout-icon を使用し、 コールアウトCSS変数開発者リファレンス に利用可能な変数が一覧表示されています。

有用なカスタムコールアウトの例

具体的なカスタムタイトルのアイデア：

• [!clue]：小説家が章をまたいで伏線やヒントを追跡するため

• [!risk]：エンジニアリング文書で技術的・ビジネス的リスクを指摘するため

• [!meeting]：日付付き会議メモの冒頭でのアクション要約用

• [!definition]：ナレッジベースで用語定義エントリーを標準化するため

これらはVaultの .obsidian/snippets フォルダにCSSスニペットを追加することでスタイル適用できます。

CSSトラブルシューティング

以下の順序で確認してください：

1. CSSファイルをVaultの .obsidian/snippets フォルダに置き、 設定 → 外観 → CSSスニペット で有効化し、スニペットを再読み込みします。
2. ノート内のタイプとセレクタが完全に一致しているか確認します（例： [!decision] には .callout[data-callout="decision"] が必要）。
3. カスタムタイプ名は両方の場所で小文字に統一します。 組み込みの識別子は大文字と小文字を区別しませんが、 Obsidianフォーラムのトラブルシューティング報告 では、大文字小文字の不一致によりカスタムセレクタが一致しなくなる例が示されています。
4. インストールされているObsidianバージョンに含まれるアイコンを使用します。

コールアウトの検索・管理・エクスポート

"[!todo]" のようなクエリで検索することで、すべてのtodoコールアウトを見つけることができます。パスフィルターと組み合わせることも可能です： path:"Drafts" "[!clue]" 。

制限事項と互換性に関するメモ

コールアウトは標準のCommonMark仕様の一部ではありません。TyporaやGitHubなどのエディタでは、通常のネストされた引用ブロックに降格されます。

一部のモバイルMarkdownアプリではプレーンテキストとして表示されます。コンテンツの可読性は維持されますが、色やアイコンは表示されません。

ネストや折りたたみ可能なコールアウトを多用すると、古いモバイルデバイスでの描画パフォーマンスが低下する可能性があります。

エクスポート（PDF、DOCX、HTML）を定期的にテストし、コールアウト内の重要なコンテンツが正しく表示されるか確認してください。コラボレーターが同じ規則に従うよう、Vault内にスタイルガイドドキュメントを維持することを検討してください。

よくある構文エラー

折りたたみマーカーはタイプ識別子に隣接させる必要があります：

> [!faq]- 既定で折りたたむ
> このコンテンツは最初は非表示になります。

> [!faq] - 既定で折りたたむ はハイフンの前にスペースがあるため、ドキュメント化された折りたたみ構文ではありません。折りたたみが表示されない場合は、ノートが閲覧ビューまたはライブプレビューになっているか確認し、ブロックを公式例と比較してください。2024年のObsidianフォーラム報告では、余分なスペースが折りたたまれない原因として特定されています。

コールアウトはObsidianの拡張機能であり、標準のCommonMarkの一部ではありません。他のMarkdownエディタでコールアウトが通常の引用ブロックとして表示されるのは正常です。コンテンツの可読性は維持されますが、Obsidianのスタイルや折りたたみ機能は引き継がれません。

まとめ

Obsidian Calloutは、ノートの執筆フローを中断することなく、情報を強調、グループ化、非表示にできる拡張引用ブロックです。

まとめ：

• 基本構文をマスターする： > [!type] タイトル

• 自分のワークフローに合った少数のタイプを選ぶ

• プロセスを支援する場合にのみカスタムCSSを追加する

日々のデイリーノート、プロジェクト、レビュー、会議テンプレートを最初から接続して運用したい場合は、 Obsibrain がObsidian向けの完成済みローカルシステムを提供しています。