obsidian-markdown について
標準 Markdown の知識がある人向けに、Obsidian Flavored Markdown の有効なノートを作成・編集するスキルです。wikilink、埋め込み、プロパティ、コールアウトなど、Obsidian 固有の記法を扱います。
主な機能
- 01ノートへのプロパティ追加
- 02内部 wikilink の作成
- 03ノート・画像・PDF の埋め込み
- 04コールアウトと折りたたみ表示
- 05タグ・コメント・ハイライトの使用
活用シーン
- 01Obsidian で構造化ノートを作成
- 02Vault 内のノートや見出しを相互リンク
- 03別ファイルの内容をノート内に表示
- 04Obsidian の閲覧ビューで表示を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ timlai666/ skills --skill obsidian-markdownインストール後、Claude Code で/obsidian-markdownを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/CALLOUTS.mdEMBEDS.mdPROPERTIES.md詳細
Obsidian Flavored Markdown スキル
有効な Obsidian Flavored Markdown を作成、編集します。Obsidian は CommonMark と GFM を拡張し、ウィキリンク、埋め込み、コールアウト、プロパティ、コメントなどの構文を追加しています。このスキルでは Obsidian 固有の拡張のみを扱います。標準的な Markdown(見出し、太字、斜体、リスト、引用、コードブロック、表)は習得済みであることを前提とします。
ワークフロー:Obsidian ノートの作成
- ファイルの先頭にプロパティ(タイトル、タグ、エイリアス)を含むフロントマターを追加します。すべてのプロパティタイプについては、PROPERTIES.md を参照してください。
- 標準的な Markdown で構成を整え、以下の Obsidian 固有の構文を使ってコンテンツを記述します。
- 内部の保管庫内でノートをつなぐにはウィキリンク(
[[Note]])を、外部 URL には標準的な Markdown リンクを使って、関連するノートにリンクします。 ![[embed]]構文を使って、他のノート、画像、PDF のコンテンツを埋め込みます。すべての埋め込みタイプについては、EMBEDS.md を参照してください。> [!type]構文を使って、強調したい情報にコールアウトを追加します。すべてのコールアウトタイプについては、CALLOUTS.md を参照してください。- 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 スキルを参照してください。