1仕組みと動作原理
純粋な知識注入型スキル:SKILL.md が Obsidian 方言 Markdown の全拡張構文をモデルコンテキストに注入し、スクリプト・ネットワーク・依存関係なしでモデルが正当な .md を生成できるようにします。
skills/obsidian-markdown/SKILL.md
This skill enables skills-compatible agents to create and edit valid Obsidian Flavored Markdown, including all Obsidian-specific syntax extensions.
ここで行っていること:スキルの適用範囲を「Obsidian 方言 Markdown の読み書き」と定義。
まず方言の構成を説明:CommonMark + GFM + LaTeX + Obsidian 独自拡張の組み合わせ。
skills/obsidian-markdown/SKILL.md
Obsidian uses a combination of Markdown flavors:
ここで行っていること:後続の各構文ブロックが属する仕様レイヤーを明確化。
内部リンクにはウィキリンクを使用し、見出し・ブロック参照・検索リンク・エイリアス表示に対応。ブロック ID の定義方法も提示。
skills/obsidian-markdown/SKILL.md
Define a block ID by adding `^block-id` at the end of a paragraph:
ここで行っていること:[[Note#^id]] と ^id 定義のペアを分かりやすく解説し、リンク可能なブロックの要点を提示。
Markdown 形式のリンクではスペースの %20 への URL エンコードを要求し、obsidian:// プロトコルにも対応。
skills/obsidian-markdown/SKILL.md
Note: Spaces must be URL-encoded as `%20` in Markdown links.
ここで行っていること:標準的な Markdown との細かな差異を指摘。
埋め込み構文はノート/画像/音声/PDF/リスト/検索結果を網羅し、サイズ指定パラメータにも対応。
skills/obsidian-markdown/SKILL.md
![[image.png|640x480]] Width x Height
ここで行っていること:埋め込みのサイズ指定構文を実例で提示。
コールアウトには固定タイプ表(note/info/tip/warning など 13 種類)とエイリアスがあり、折りたたみや入れ子にも対応。
skills/obsidian-markdown/SKILL.md
### Supported Callout Types
ここで行っていること:コールアウトのタイプ、エイリアス、色、アイコンを網羅的に提示。
プロパティ(frontmatter)の型を区別し、デフォルトフィールド tags/aliases/cssclasses を明記。
skills/obsidian-markdown/SKILL.md
Properties use YAML frontmatter at the start of a note:
ここで行っていること:ノートのメタデータ記述方法を標準化。
数式には LaTeX(インライン $...$ / ブロック $$...$$)、図表には Mermaid を使用し、完全な総合例も付属。
skills/obsidian-markdown/SKILL.md
This is inline math: $e^{i\pi} + 1 = 0$
ここで行っていること:学術ノートで頻出する数式や図表の表現力をカバー。
2コア機能
01Wikilinks 内部リンク:エイリアス表示、見出し/ブロック位置指定、検索リンク
02ブロック参照:^block-id 定義と [[Note#^id]] 参照
03埋め込み:ノート/画像(サイズ指定対応)/音声/PDF(ページ指定対応)/リスト/検索結果
04Callouts:エイリアスを含む 13 種類、カスタムタイトル、折りたたみと入れ子、カスタム CSS
05プロパティ frontmatter:型の区別およびデフォルトフィールド tags/aliases/cssclasses
06数式(LaTeX インライン/ブロック)、Mermaid 図(flowchart/sequence/internal-link)
07テーブルと配置、パイプのエスケープ、コードブロック(入れ子テクニック含む)
08タグ構文(ネスト/ハイフン/アンダースコア)、コメント、脚注、HTML コンテンツ
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
自動ロード可能
管理者向け
ソースとバージョンの記録
判定根拠(ファイルパスと抜粋)
- SKILL.md: 純粋なプロンプト指示およびルールテキストであり、スクリプト実行や外部影響は一切なし
監査ノート: 純粋な指示型:単一ファイル SKILL.md(621 行)はすべて構文仕様であり、§3 スキャンにおいてスクリプト実行、ネットワーク要求、認証情報読み取り、ディスク書き込みは確認されず、危険フラグなし。ディレクトリ内は 1 ファイルのみ。
5二重目の独立検証
- [ok] 文件面核对 — §1 仅 skills/obsidian-markdown/SKILL.md(10813 字节 / 621 行),无 scripts/references/assets。
- [ok] URL 命中性质复核 — §3 的 14 条 URL:commonmark.org/gfm/latex 与 help.obsidian.md 为文档链接,example.com 两条为示例占位符;均非运行时调用。
- [ok] 安全结论反例搜索 — §3 凭证/外部程序/写盘/网络请求/危险旗标全部无命中。
- [ok] 能力是否夸大 — description 声明的 wikilinks/embeds/callouts/properties 在 §2 均有独立章节与示例。
- [ok] 档位判定复核 — 纯指令单文件、无任何执行面 → 🟢 green 成立。
6結論
最適な用途: Obsidian でノートを作成・編集するユーザー:wikilinks、callouts、frontmatter、埋め込み、数式、Mermaid の標準記法を必要とする場合や、構文エラーを防ぐために Obsidian 方言を知識注入したい場合。
不向きな用途: Obsidian 以外の Markdown 環境(標準 GFM/CommonMark では本スキルは不要);スキルによる直接のレンダリングやプレビュー生成が必要な場合;上流の最新構文への頻繁な追従が求められる環境。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload obsidian-markdown.tar.gz
sha256:
Option B · Copy Guide for Agent0fe5017b220b50e4…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit dd0bf35595.