obsidian-links Checked

Format and validate Obsidian wiki links with proper filename, section, and folder conventions. Verify links exist before creation and fix broken links. Use when creating or checking wiki links in markdown files.

Obsidian Wiki Links

Format, validate, and fix wiki links according to vault conventions.

Format and validate Obsidian wiki links with proper filename, section, and folder conventions. Verify links exist before creation and fix broken links. Use when creating or checking wiki links in markdown files.

Obsidian Wiki Links

Format, validate, and fix wiki links according to vault conventions.

When to Use This Skill

Activate when you need to:

• Create wiki links to other vault files
• Add section links to specific headers
• Format links in YAML frontmatter properties
• Verify links point to existing files/sections
• Find and fix broken links
• Validate link integrity in documents

Core Link Formatting Rules

### 1. Complete Filename Format

**Always use full filename with date prefix**:

✅ CORRECT: [[2025-10-31 Project Notes]]
❌ INCORRECT: [[Project Notes]] (missing date)
❌ INCORRECT: [[2025-10-31]] (missing title)

### 2. Folder Path Conventions

**Include folder prefix for clarity**:

✅ CORRECT: [[Journal/2025-10-31]]
✅ CORRECT: [[Articles/2025-10-31 Perennial Seller]]
✅ CORRECT: [[Roundup/2025-10-31]]

**Rule**: Use consistent folder prefixes for clarity and navigation.

### 3. Section Links

**Use exact header text, character-for-character**:

Source file header:
## PKM System Maintenance

✅ CORRECT:
[[Journal/2025-10-31#PKM System Maintenance]]

❌ INCORRECT:
[[Journal/2025-10-31#PKM System]] (truncated)
[[Journal/2025-10-31#pkm-system-maintenance]] (slug format)

**Critical**: Match characters, punctuation, spacing exactly as written.

### 4. Link to Sources, Not Indices

**Always link to original content, not topic aggregations**:

✅ CORRECT: [[Articles/2025-08-15 Skill Development]]
❌ INCORRECT: [[Topics/Career#Skill Development]]

Reason: Maintains source attribution and traceability

### 5. Properties Link Format

**Wrap links in quotes when used in YAML lists**:

sources:
  - "[[Journal/2025-10-31]]"
  - "[[Articles/2025-10-31 Title]]"

links:
  - "[[Roundup/2025-10-31]]"

attendees:
  - "[[People/John]]"

Link Validation Principles

### 1. Search Before Link

**ALWAYS verify target exists before creating link**:

Process:
1. Search for target file using Glob or Grep
2. Verify file exists
3. If section link, read file and verify header exists
4. Create link with exact filename and header text

❌ NEVER:
- Guess at filenames
- Assume files exist
- Fabricate section headers

### 2. Verify Section Headers

**For section links, read source and match exactly**:

Steps:
1. Read target file
2. Search for exact header text
3. Copy character-for-character (including special characters)
4. Create section link

If unsure about exact header:
✅ Link to file only: [[Journal/2025-10-31]]
❌ Don't guess: [[Journal/2025-10-31#Guessed Header]]

### 3. File Existence Checking

**Use appropriate tools to verify files**:

For specific file:
- Use Glob with full path pattern: "Journal/2025-10-31.md"
- Or Read the file directly