obsidian-wsl-vault-access — obsidian-wsl-vault-访问

Obsidian Vault (WSL)

Use this 技能 when the vault lives on Windows but is being 访问ed from WSL through /mnt/.

工作流 Identify the vault root from the user-provided path before doing broad 搜索es or edits. Operate on the file系统 path directly; Obsidian does not require a special API for normal note work. Preserve existing frontmatter, wiki-links, embeds, headings, and folder structure unless the user asks to change them. Vault Location

Do not assume a fixed vault path.

Common patterns:

Windows: C:\Users\\Documents\\ Windows: D:\Notes\\ WSL: /mnt/c/Users//Documents// WSL: /mnt/d/Notes//

Treat the vault root as the directory contAIning the Obsidian note tree.

Path Translation Windows -> WSL: C:\path\to\file -> /mnt/c/path/to/file Windows -> WSL: D:\path\to\file -> /mnt/d/path/to/file WSL -> Windows: /mnt/c/path -> C:/path WSL -> Windows: /mnt/d/path -> D:/path

Replace backslashes with forward slashes and lowercase the drive letter under /mnt/.

Common Operations Read a note cat "/mnt////.md"

搜索 the vault

Prefer rg for speed:

rg "搜索 term" "/mnt///"

Edit a note

Edit the markdown file in place with tar获取ed changes instead of rewriting the whole note when possible.

创建 a new note

Use a minimal template when metadata is needed:

# Note Title

Obsidian Conventions Notes are markdown files ending in .md YAML frontmatter is commonly used for metadata such as title, tags, and aliases Internal links use [[Note Name]] Embeds use ![[Note Name]] Callouts use > [!type] Working Rules Confirm the vault root before making broad 搜索es or bulk changes Prefer tar获取ed edits over full-file rewrites Keep filenames, wiki-links, and folder structure consistent with the existing vault