json-canvas

Obsidian のキャンバスを、エージェントに作らせたり直させたりしたいときに効きます。キャンバスは、付箋やノートを平面に並べて線でつなぐ Obsidian の機能で、中身は JSON Canvas という公開の仕様の JSON です。

節点は 4 種類

• 文字（text）Markdown の文
• ファイル（file）保管庫の中のノートや画像。見出しへの飛び先も付けられる
• リンク（link）外部の URL
• グループ（group）他の節点を囲む枠。名前と背景の画像を付けられる

線のつなぎ方

線（edge）は、つなぐ元と先の節点の ID、出る辺と入る辺（上下左右）、矢印の有無、色、ラベルで表します。

どの作業も最後に確かめる

作る・足す・つなぐ・直す、の 4 つの作業の手順があり、どれも最後に確かめるのが決まりです。ID が重複していないか、線の元と先が実在する節点を指しているかを見ます。

同じリポジトリの 5 件の組み方と入れ方は、Obsidian の地図にまとめています。

ノートを表として並べたいとき

同じ公開元の obsidian-bases です。

Obsidian の Markdown の書き方

内部リンクや埋め込みなら obsidian-markdown です。

配置を自動で美しく整えたいとき

座標は数値で決めて書くので、込み入った図の見栄えは Obsidian で開いて直すことになります。

解析で見つかったこと

SKILL.md の解析では、外部通信・シェル実行・ファイル操作の記述は見つかっていません。obsidian.md への言及があります。同梱ファイルは 1 件で、キャンバスの作例集（文字と線の簡単な例・グループで分けたプロジェクトの板・ファイルとリンクを並べた調べもの・フローチャートの 4 例）です。

改行は \n で書きます

重なりの順番は配列の順です

節点の配列の先頭が一番下、最後が一番上に描かれます。グループの枠と中の節点の重なりも、この順で決まります。

ID の形は Obsidian の流儀です

本文は 16 桁の 16 進の ID を作れ、としていますが、JSON Canvas の仕様が求めるのは「重複しない文字列」です（JSON Canvas 1.0 の仕様）。他の道具で作ったキャンバスの ID が違う形でも、誤りではありません。

インストール数

インストール数は約 6.8 万件です。同じリポジトリの 5 件は約 6.7 万〜8.4 万件に収まっていて（2026-09-07 の上流集計）、まとめて入る配布の形です。

色は指定できますか

できます。"1"〜"6" の決まった色か、"#FF0000" のような 16 進の値です。節点にも線にも付けられます。

既存のキャンバスに足すときの置き場所は

本文は、既存の節点と重ならないように、50〜100 ピクセルの間を空けて置け、としています。