mcpField
O
obsidian-templater

obsidian-templater

github.com/nweii生産性1091 回インストール1 週間前に更新
リポジトリ

obsidian-templater について

obsidian-templaterは、動的なノートテンプレートを扱うObsidianユーザー向けのスキルです。Templaterの構文、JavaScript実行ブロック、組み込みAPI、日付処理を説明します。

主な機能

  1. 01動的な式とコードブロック
  2. 02テンプレート内の空白制御
  3. 03組み込みtp.*関数の利用
  4. 04Moment.jsによる日付形式指定
  5. 05ノートテンプレートの実装例

活用シーン

  1. 01動的な内容を含むノートの生成
  2. 02フォルダー条件付きテンプレートの作成
  3. 03テンプレート内の日付処理
  4. 04tp.* APIの確認やデバッグ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nweii/agent-stuff --skill obsidian-templater

インストール後、Claude Code で/obsidian-templaterを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
examples.md
modules.md
momentjs.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 をご覧ください。

コメント