Vault Blog Core におけるファイルパスの扱いについて

Vault Blog Core における投稿用ファイルのパスの扱いには、いくつか注意点があります。
Markdown ファイル、画像、音声、動画など、すべての種類のファイルに共通して次の点に注意してください。

ディレクトリ構造は入れ子にしない

の各ディレクトリは 直下のファイルのみを探索 します。
（現時点ではサブディレクトリの再帰探索には対応していません。）

そのため、各ファイルはそれぞれのディレクトリ 直下に直接配置 する必要があります。

Example

✅ 正しい構成
POST_SOURCE_DIR/
  ├─ post1.md
  └─ post2.md

❌ 誤った構成（孫ディレクトリ以下は探索されない）
POST_SOURCE_DIR/
  └─ 2025/
      └─ post1.md

Note

この仕様は、開発者のノート環境（Obsidian）との整合性を重視した設計によるものです。
Obsidian を使用している場合、Vault 内のディレクトリ構造を単純に保つことで、特に不便なく運用できると思います。

記事を書く際、本文で他の記事へのリンクを貼りたいとはの記事に対応する Markdown ファイルの basename のみを Wiki リンクで記述してください。

Example

[[ファイルパスの扱いについて]]

Callout の変換例にも例が載っています。

Note

この仕様も、Obsidian との整合性を重視した設計によるものです。
Obsidian を使用している場合、特に不便なく運用できると思います。

記事を書く際、本文で他の画像・音声・動画ファイルへのリンクを貼りたいときは、basename と拡張子のみを埋め込み Wiki リンクで記述してください。

Example

![[thumbnail.png]]
![[bgm.mp3]]
![[movie.mp4]]

Callout の変換例にも例が載っています。

Note

この仕様も、Obsidian との整合性を重視した設計によるものです。
Obsidian を使用している場合、特に不便なく運用できると思います。