mcpField
O
obsidian-markdown

obsidian-markdown

github.com/timlai666生産性038 回インストール今日更新
リポジトリ

obsidian-markdown について

標準 Markdown の知識がある人向けに、Obsidian Flavored Markdown の有効なノートを作成・編集するスキルです。wikilink、埋め込み、プロパティ、コールアウトなど、Obsidian 固有の記法を扱います。

主な機能

  1. 01ノートへのプロパティ追加
  2. 02内部 wikilink の作成
  3. 03ノート・画像・PDF の埋め込み
  4. 04コールアウトと折りたたみ表示
  5. 05タグ・コメント・ハイライトの使用

活用シーン

  1. 01Obsidian で構造化ノートを作成
  2. 02Vault 内のノートや見出しを相互リンク
  3. 03別ファイルの内容をノート内に表示
  4. 04Obsidian の閲覧ビューで表示を確認

インストール

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

$npx skills add https://github.com/timlai666/skills --skill obsidian-markdown

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

同梱ファイル

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

references/
CALLOUTS.md
EMBEDS.md
PROPERTIES.md

詳細

Obsidian Flavored Markdown スキル

有効な Obsidian Flavored Markdown を作成、編集します。Obsidian は CommonMark と GFM を拡張し、ウィキリンク、埋め込み、コールアウト、プロパティ、コメントなどの構文を追加しています。このスキルでは Obsidian 固有の拡張のみを扱います。標準的な Markdown(見出し、太字、斜体、リスト、引用、コードブロック、表)は習得済みであることを前提とします。

ワークフロー:Obsidian ノートの作成

  1. ファイルの先頭にプロパティ(タイトル、タグ、エイリアス)を含むフロントマターを追加します。すべてのプロパティタイプについては、PROPERTIES.md を参照してください。
  2. 標準的な Markdown で構成を整え、以下の Obsidian 固有の構文を使ってコンテンツを記述します。
  3. 内部の保管庫内でノートをつなぐにはウィキリンク([[Note]])を、外部 URL には標準的な Markdown リンクを使って、関連するノートにリンクします。
  4. ![[embed]] 構文を使って、他のノート、画像、PDF のコンテンツを埋め込みます。すべての埋め込みタイプについては、EMBEDS.md を参照してください。
  5. > [!type] 構文を使って、強調したい情報にコールアウトを追加します。すべてのコールアウトタイプについては、CALLOUTS.md を参照してください。
  6. Obsidian の閲覧ビューでノートが正しく表示されることを確認します。

ウィキリンクと Markdown リンクを使い分ける場合は、保管庫内のノートには [[wikilinks]] を使います(Obsidian が名前の変更を自動的に追跡します)。外部 URL にのみ [text](url) を使います。

内部リンク(ウィキリンク)

[[Note Name]]                          Link to note
[[Note Name|Display Text]]             Custom display text
[[Note Name#Heading]]                  Link to heading
[[Note Name#^block-id]]                Link to block
[[#Heading in same note]]              Same-note heading link

段落の末尾に ^block-id を追加して、ブロック ID を定義します。

This paragraph can be linked to. ^my-block-id

リストと引用では、ブロックの後にブロック ID を別の行に配置します。

> A quote block

^quote-id

埋め込み

ウィキリンクの先頭に ! を付けると、コンテンツをインラインで埋め込めます。

![[Note Name]]                         Embed full note
![[Note Name#Heading]]                 Embed section
![[image.png]]                         Embed image
![[image.png|300]]                     Embed image with width
![[document.pdf#page=3]]               Embed PDF page

音声、動画、検索結果の埋め込み、および外部画像については、EMBEDS.md を参照してください。

コールアウト

> [!note]
> Basic callout.

> [!warning] Custom Title
> Callout with a custom title.

> [!faq]- Collapsed by default
> Foldable callout (- collapsed, + expanded).

一般的なタイプ:note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。

エイリアス、ネスト、カスタム CSS コールアウトを含む全リストについては、CALLOUTS.md を参照してください。

プロパティ(フロントマター)

---
title: My Note
date: 2024-01-15
tags:
  - project
  - active
aliases:
  - Alternative Name
cssclasses:
  - custom-class
---

既定のプロパティ:tags(検索可能なラベル)、aliases(リンク候補に表示するノートの別名)、cssclasses(スタイル設定に使う CSS クラス)。

すべてのプロパティタイプ、タグ構文のルール、高度な使い方については、PROPERTIES.md を参照してください。

タグ

#tag                    Inline tag
#nested/tag             Nested tag with hierarchy

タグには、文字、数字(先頭文字を除く)、アンダースコア、ハイフン、スラッシュを使用できます。タグはフロントマターの tags プロパティで定義することもできます。

コメント

This is visible %%but this is hidden%% text.

%%
This entire block is hidden in reading view.
%%

Obsidian 固有の書式設定

==Highlighted text==                   Highlight syntax

数式(LaTeX)

Inline: $e^{i\pi} + 1 = 0$

Block:
$$
\frac{a}{b} = c
$$

図(Mermaid)

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do this]
    B -->|No| D[Do that]
```

Mermaid のノードから Obsidian のノートにリンクするには、class NodeName internal-link; を追加します。

脚注

Text with a footnote[^1].

[^1]: Footnote content.

Inline footnote.^[This is inline.]

完全な例

---
title: Project Alpha
date: 2024-01-15
tags:
  - project
  - active
status: in-progress
---

# Project Alpha

This project aims to [[improve workflow]] using modern techniques.

> [!important] Key Deadline
> The first milestone is due on ==January 30th==.

## Tasks

- [x] Initial planning
- [ ] Development phase
  - [ ] Backend implementation
  - [ ] Frontend design

## Notes

The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.

![[Architecture Diagram.png|600]]

Reviewed in [[Meeting Notes 2024-01-10#Decisions]].

既定の保管庫アーキテクチャ

新しい Obsidian 保管庫を初期化するとき、または構造を一から作成するときは、常に llm-wiki 構造(SCHEMA.md、index.md、log.md、raw/、topics/、entities/、concepts/、comparisons/、queries/ で構成)を既定として使用します。詳細は llm-wiki スキルを参照してください。

参考資料

コメント