ynitto Obsidian Use
Obsidian に関連するすべての操作をカバーする統合スキル。5つの機能領域を提供する。
前提条件（外部ツール）
各機能の利用前にツールがインストールされていることを確認する:
| ツール | 用途 | インストール |
|---|---|---|
Obsidian CLI (obsidian) |
ボルト操作・プラグイン開発 | npm install -g @anthropics/obsidian-cli（Obsidianが起動している必要あり） |
Defuddle (defuddle) |
URL・HTMLファイル → Markdown 抽出 | npm install -g defuddle |
markitdown (markitdown) |
Office / PDF → Markdown 変換 | pip install markitdown |
ファイル種別→ツール選択
渡されたファイルの種類によって使うツールを選択する:
| ファイル種別 | 使うツール | 参照 |
|---|---|---|
.html / .htm（ローカルファイル） |
defuddle | references/defuddle.md |
| URL（http/https） | defuddle | references/defuddle.md |
.docx / .xlsx / .pptx |
markitdown → ofm_formatter.py → LLM | references/markitdown.md |
.pdf |
markitdown → ofm_formatter.py → LLM | references/markitdown.md |
.md ファイルのURL |
WebFetch を直接使う | — |
機能領域の選択
| タスク | 参照 |
|---|---|
| .md ファイルの作成・編集（ウィキリンク、コールアウト、埋め込み等） | references/obsidian-markdown.md |
| .base ファイルの作成・編集（Bases、フィルター、フォーミュラ、ビュー） | references/obsidian-bases.md |
| .canvas ファイルの作成・編集（JSONキャンバス、ノード、エッジ） | references/json-canvas.md |
| Obsidian CLIコマンド（ボルト操作、ノート管理、プラグイン開発） | references/obsidian-cli.md |
| WebページからMarkdownを抽出（Defuddle） | references/defuddle.md |
| OfficeファイルをObsidian Markdownに変換（markitdown） | references/markitdown.md |
各機能の概要
Obsidian Flavored Markdown（.md ファイル）
ObsidianはCommonMarkとGFMを独自記法で拡張している。主な機能:
- ウィキリンク (
[[ノート名]]): ボルト内ノートへの内部リンク（名前変更時も自動追跡） - 埋め込み (
![[ファイル名]]): ノート・画像・PDFをインライン表示 - コールアウト (
> [!type]): 情報をハイライト表示するコンテナ - プロパティ (YAMLフロントマター): タグ・エイリアス・カスタムCSSクラスなど
詳細: references/obsidian-markdown.md
Obsidian Bases（.base ファイル）
.base ファイルはYAMLで記述するデータベースライクなビュー。主な機能:
- フィルター: タグ・フォルダ・プロパティ・日付でノートを絞り込む
- フォーミュラ: プロパティから計算値を生成
- ビュー: table・cards・list・mapの4種類
詳細: references/obsidian-bases.md
JSON Canvas（.canvas ファイル）
.canvas はJSON Canvas Spec 1.0に準拠したビジュアルキャンバス。主な機能:
- ノード: text/file/link/groupの4種類
- エッジ: ノード間の接続線（ラベル・矢印・色対応）
- 16文字hexのユニークIDでノードとエッジを識別
詳細: references/json-canvas.md
Obsidian CLI
obsidian CLIでObsidianの実行中インスタンスを操作（Obsidianが開いている必要あり）。主な機能:
- ノートの読み取り・作成・追記・検索
- タスク・デイリーノート・プロパティ管理
- プラグイン・テーマ開発（リロード・デバッグ・スクリーンショット）
詳細: references/obsidian-cli.md
Defuddle（URL・HTMLファイルのコンテンツ抽出）
defuddle CLIでWebページ・ローカルHTMLファイルから不要な要素（ナビゲーション・広告など）を除去し、クリーンなMarkdownを抽出する。URLやHTMLファイルを読む際はWebFetchよりもトークン効率が良い（.mdファイルには使わない）。
詳細: references/defuddle.md
markitdown（Office/PDFファイル変換）
markitdown CLIでOffice/PDFファイル（Word・Excel・PowerPoint・PDF等）をMarkdownに変換する。変換後に ofm_formatter.py で機械的後処理（フロントマター付加・画像パス変換・内部リンクのウィキリンク化）を行い、さらにLLMがコールアウト変換・タグ推定等の意味的整形を行う（2段階ハイブリッド方式）。HTMLファイルはdefuddleを使うこと。
詳細: references/markitdown.md / スクリプト: references/ofm_formatter.py
クロスドメインワークフロー例
Web記事をObsidianノートに取り込む（URLの場合）
# 1. DefuddleでWebページをクリーンなMarkdownに変換
defuddle parse <url> --md -o article.md
# 2. ウィキリンクやフロントマターを整形（エージェントが意味的に加工）
# （フロントマター追加・固有名詞をウィキリンク化）
# 3. Obsidian CLI でボルトに保存
obsidian create name="記事タイトル" content="$(cat article.md)" silent
HTMLファイルをObsidianノートに取り込む
# 1. DefuddleでローカルファイルをクリーンなMarkdownに変換
defuddle parse article.html --md -o article.md
# 2. エージェントが意味的整形（フロントマター追加・ウィキリンク化）
# 3. Obsidian CLI でボルトに保存
obsidian create name="記事タイトル" content="$(cat article.md)" silent
Office/PDFファイルをObsidianノートに変換する
# 1. markitdownでOffice/PDFファイルをMarkdownに変換
markitdown document.docx -o raw.md
# 2. ofm_formatter.py で機械的後処理（フロントマター・画像パス・内部リンク）
python references/ofm_formatter.py raw.md note.md
# 3. エージェントがLLM意味的整形（コールアウト変換・タグ推定）
# （note.md を読んでコールアウト等を変換）
# 4. Obsidian CLI でボルトに保存
obsidian create name="ドキュメント名" content="$(cat note.md)" silent