コンテンツ制作 · freestylefly/canghe-skills

obsidian-markdown

ウィキリンク、埋め込み、コールアウト、プロパティ、その他のObsidian固有構文を含むObsidian Flavored Markdownを作成および編集します。Obsidian内の.mdファイルを操作する場合や、ユーザーがウィキリンク、コールアウト、フロントマター、タグ、埋め込み、Obsidianノートに言及した際に使用します。

L1 基本 · ソース登録のみV1 コミット固定Dual-pass Audit
Author freestyleflyGitHub freestylefly/canghe-skills ↗License MIT(仓库根 LICENSE)Commit dd0bf35595
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

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 方言 Markdown を完全網羅し、公式ドキュメントを参照する手間を単一ファイルで解消。
  • frontmatter/wikilinks/callouts/mermaid/脚注/コメントを含む、そのまま流用可能な総合実例を収録。
  • テーブル形式の構文クイックリファレンスにより、検索コストが低い。
  • 最適な用途: 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: 0fe5017b220b50e4…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit dd0bf35595.