obsidian-templater について
obsidian-templaterは、動的なノートテンプレートを扱うObsidianユーザー向けのスキルです。Templaterの構文、JavaScript実行ブロック、組み込みAPI、日付処理を説明します。
主な機能
- 01動的な式とコードブロック
- 02テンプレート内の空白制御
- 03組み込みtp.*関数の利用
- 04Moment.jsによる日付形式指定
- 05ノートテンプレートの実装例
活用シーン
- 01動的な内容を含むノートの生成
- 02フォルダー条件付きテンプレートの作成
- 03テンプレート内の日付処理
- 04tp.* APIの確認やデバッグ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ nweii/ agent-stuff --skill obsidian-templaterインストール後、Claude Code で/obsidian-templaterを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/examples.mdmodules.mdmomentjs.md詳細
Templater テンプレートの生成
Templater は、動的なノートテンプレートを作成するための Obsidian プラグインです。テンプレートファイルに埋め込まれたコマンドは、テンプレートをノートに適用すると実行され、その結果がインラインで出力されます。
基本的なテンプレート構文
| タグ | 動作 |
|---|---|
<% expression %> | 式の結果を出力します |
<%* code %> | JS コードを実行します。デフォルトでは出力しません |
<%+ expression %> | プレビューモードで再評価します(非推奨のため使用しないでください) |
<%- / -%> | タグの前後にある改行を1つ削除します |
<%_ / _%> | タグの前後にあるすべての空白を削除します |
<%* %> 実行ブロックから出力するには、特別な tR 文字列に追記します。
<%* tR += "some output" %>
ある位置までに生成された内容をすべて破棄するには(例:テンプレート専用のフロントマターを削除する場合):
<%* tR = "" -%>
すべての tp.* 関数は、どちらのタグ形式でも使用できます。
組み込みモジュール
tp.* API を選択またはデバッグする際は、references/modules.md をお読みください。同期動作、プロパティと関数の違い、非同期の要件、実行モード、フック、ユーザー関数の制限について、正確な情報を確認できます。
テンプレートの空白制御
制御フロータグ(<%* if (...) { %>、<%* } %>)は、デフォルトでは空行を残します。タグの後に続く改行を削除するには、-%> を使用します。
<%* if (tp.file.folder() === "Work") { -%>
**Project:** <% tp.frontmatter.project %>
<%* } else { -%>
General note
<%* } -%>
実装例
デイリーノート、プロンプト付きのメタデータと名前変更、テンプレート専用フロントマターの削除、フォルダー条件分岐、ノートの挿入に使える一連のパターンについては、references/examples.md をお読みください。
Moment.js による日付の書式設定
包括的な書式設定チートシートと JS による操作のリファレンスについては、momentjs.md をご覧ください。tp.date.now() の format 文字列を定義するときや、moment グローバルを使って <%* %> ブロック内で日付を操作するときにご利用ください。
obsidian-clis によるオプションの Vault 連携
obsidian-clis スキルが利用可能で、Obsidian が実行中の場合は、Vault のコンテキストを利用して出力を改善できます。
obsidian properties counts # what frontmatter properties exist across the vault
obsidian tags counts sort=count # most-used tags
obsidian read file="Daily Note" # read an existing template for style reference
Vault の指示に従い、ユーザーの依頼の範囲内で関連する読み取り専用の CLI チェックを実行してください。テンプレートの作成または更新の依頼は、該当範囲内の書き込みを許可するものです。未解決の選択肢、破壊的な変更、またはユーザーが希望するレビューの確認段階についてのみ、質問してください。環境の実行権限に従ってください。
公式ドキュメントへのリンク
レンダリング済みドキュメント(人間向け): https://silentvoid13.github.io/Templater/
LLM に適した Templater の概要: 公式 Templater ドキュメントを前処理した、監査しやすい概要については、https://context7.com/silentvoid13/templater/llms.txt をご覧ください。