obsidian

name	obsidian
version	1.1.0
description	Local-first knowledge management with markdown vaults, bidirectional linking, plugin ecosystem, and practical vault file operations.
author	workspace-hub
category	business
type	skill
capabilities	["markdown_knowledge_base","bidirectional_linking","graph_visualization","plugin_ecosystem","templating_automation","dataview_queries","sync_strategies","backup_workflows"]
tools	["obsidian","obsidian-cli","dataview","templater","git"]
tags	["obsidian","knowledge-management","markdown","zettelkasten","pkm","productivity"]
platforms	["desktop","mobile","linux","macos","windows","ios","android"]
related_skills	["yaml-configuration","git-sync-manager"]
requires	[]
scripts_exempt	true

Obsidian

When to Use

Use Obsidian when you want a local-first markdown vault with links, durable files, and flexible automation. It fits personal knowledge management, project notes, research notes, journals, and operational runbooks.

Do not use it when you need live multi-user collaboration, database-style workflows, or permission-heavy enterprise knowledge bases.

Basic Vault Operations

Typical vault path handling:

export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian Vault"
ls "$OBSIDIAN_VAULT_PATH"
find "$OBSIDIAN_VAULT_PATH" -name '*.md' | head

Always quote vault paths because spaces are common.

Read a note:

cat "$OBSIDIAN_VAULT_PATH/Projects/My Project.md"

Create a note:

cat > "$OBSIDIAN_VAULT_PATH/Inbox/New Note.md" <<'EOF'
# New Note

- idea
- follow-up
EOF

Append to a note:

echo "- next action" >> "$OBSIDIAN_VAULT_PATH/Projects/My Project.md"

Search by filename/content:

find "$OBSIDIAN_VAULT_PATH" -iname '*project*'
grep -R "cathodic protection" "$OBSIDIAN_VAULT_PATH"

Vault Structure

A practical starting layout:

mkdir -p "$OBSIDIAN_VAULT_PATH"/{Inbox,Projects,Areas,Resources,Archive,Templates,}