Obsidian Vault (WSL)

Use this skill when the vault lives on Windows but is being accessed from WSL through /mnt/\x3Cdrive>.

Workflow

1. Identify the vault root from the user-provided path before doing broad searches or edits.
2. Operate on the filesystem path directly; Obsidian does not require a special API for normal note work.
3. 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\\x3Cuser>\Documents\\x3Cvault>\
• Windows: D:\Notes\\x3Cvault>\
• WSL: /mnt/c/Users/\x3Cuser>/Documents/\x3Cvault>/
• WSL: /mnt/d/Notes/\x3Cvault>/

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

Path Translation

Windows -> WSL: C:\path	o\file -> /mnt/c/path/to/file
Windows -> WSL: D:\path	o\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/\x3Cdrive>.

Common Operations

Read a note

cat "/mnt/\x3Cdrive>/\x3Cvault>/\x3Cpath>/\x3Cfilename>.md"

Search the vault

Prefer rg for speed:

rg "search term" "/mnt/\x3Cdrive>/\x3Cvault>/"

Edit a note

Edit the markdown file in place with targeted changes instead of rewriting the whole note when possible.

Create a new note

Use a minimal template when metadata is needed:

---
title: Note Title
tags: []
---

# 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 searches or bulk changes
• Prefer targeted edits over full-file rewrites
• Keep filenames, wiki-links, and folder structure consistent with the existing vault