obsidian
Obsidian Knowledge Management
Complete guide for Obsidian - knowledge base on local markdown files.
Quick Reference
Key Concepts
| Concept | Description |
|---|---|
| Vault | Folder containing notes |
| Note | Markdown file |
| Link | Connection between notes |
| Tag | Categorization marker |
| Graph | Visual note connections |
File Structure
vault/
+-- .obsidian/ # Settings
| +-- plugins/
| +-- themes/
| +-- workspace.json
+-- Daily Notes/
+-- Templates/
+-- Notes/
Markdown Syntax
Internal Links
[[Note Name]] # Basic link
[[Note Name|Display Text]] # Link with alias
[[Note Name#Heading]] # Link to heading
[[Note Name#^block-id]] # Link to block
![[Note Name]] # Embed note
![[Note Name#Heading]] # Embed specific section
Tags
#tag #nested/tag # Inline tags
---
tags: [tag1, tag2] # YAML frontmatter tags
---
Callouts
> [!note]
> This is a note callout
> [!warning]
> This is a warning
> [!tip]
> This is a tip
> [!info]- Collapsed
> This is collapsed by default
Task Lists
- [ ] Incomplete task
- [x] Completed task
- [/] In progress
- [-] Cancelled
Frontmatter (YAML)
---
title: Note Title
date: 2024-01-15
tags: [tag1, tag2]
aliases: [alias1, alias2]
status: draft
author: Name
---
Templates
Daily Note Template
---
date: {{date}}
tags: [daily]
---
# {{date:dddd, MMMM D, YYYY}}
## Tasks
- [ ]
## Notes
## Journal
---
[[{{date:YYYY-MM-DD|yesterday}}|<- Yesterday]] | [[{{date:YYYY-MM-DD|tomorrow}}|Tomorrow ->]]
Meeting Template
---
date: {{date}}
tags: [meeting]
attendees:
type: meeting
---
# Meeting: {{title}}
## Attendees
-
## Agenda
1.
## Notes
## Action Items
- [ ]
Dataview Plugin
Basic Queries
# List all notes with tag
LIST FROM #tag
# Table of notes
TABLE file.ctime as Created, status
FROM "Projects"
WHERE status = "active"
SORT file.ctime DESC
# Task list
TASK FROM "Daily Notes"
WHERE !completed
GROUP BY file.link
Advanced Queries
# Books read this year
TABLE rating, author, year
FROM #book
WHERE completed AND year = 2024
SORT rating DESC
# Upcoming deadlines
TABLE due, status
FROM "Tasks"
WHERE due >= date(today) AND due <= date(today) + dur(7 days)
SORT due ASC
# Recent notes
LIST
FROM ""
WHERE file.mday >= date(today) - dur(7 days)
SORT file.mday DESC
LIMIT 10
Templater Plugin
Basic Syntax
<%* /* JavaScript code */ %>
<% /* Output */ %>
# Get current date
<% tp.date.now("YYYY-MM-DD") %>
# Get title
<% tp.file.title %>
# Create date with offset
<% tp.date.now("YYYY-MM-DD", 7) %>
# Cursor position
<% tp.file.cursor() %>
User Prompts
<%*
const title = await tp.system.prompt("Enter title");
const type = await tp.system.suggester(
["Task", "Note", "Project"],
["task", "note", "project"]
);
_%>
# <% title %>
Type: <% type %>
File Operations
<%*
// Move file
await tp.file.move("/Archive/" + tp.file.title);
// Rename file
await tp.file.rename("New Name");
// Create file
await tp.file.create_new("Content", "New Note");
%>
Vault Organization
PARA Method
vault/
+-- 1 - Projects/
+-- 2 - Areas/
+-- 3 - Resources/
+-- 4 - Archive/
+-- Templates/
Zettelkasten
vault/
+-- Fleeting/
+-- Literature/
+-- Permanent/
+-- Index/
Essential Hotkeys
Cmd/Ctrl + N New note
Cmd/Ctrl + O Quick switcher
Cmd/Ctrl + P Command palette
Cmd/Ctrl + Shift + F Search all files
Cmd/Ctrl + E Toggle edit/preview
Cmd/Ctrl + G Open graph view
Essential Plugins
Core
- Dataview: Database queries
- Templater: Advanced templates
- QuickAdd: Quick captures
- Periodic Notes: Daily/weekly notes
- Calendar: Calendar view
Productivity
- Tasks: Task management
- Kanban: Kanban boards
- Projects: Project management
- Excalidraw: Drawings
Organization
- Tag Wrangler: Tag management
- Folder Notes: Folder index
- Auto Link Title: Auto fetch titles
- Note Refactor: Split/merge notes
Git Backup
# .gitignore
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/plugins/*/data.json
.trash/
Best Practices
- Regular backups - Git or sync service
- Consistent naming - Use conventions
- Use templates - Speed up note creation
- Link liberally - Build knowledge graph
- Daily notes - Capture everything
- Review regularly - Process inbox
- Minimal plugins - Only what you need
- Frontmatter - Structured metadata
- Atomic notes - One idea per note
- Document workflows - Create guides for yourself
When to Use This Skill
- Setting up Obsidian vaults
- Creating templates and workflows
- Writing Dataview queries
- Developing Templater scripts
- Organizing knowledge bases
- Building PKM systems
More from housegarofalo/claude-code-base
postgresql
Design, optimize, and manage PostgreSQL databases. Covers indexing, pgvector for AI embeddings, JSON operations, full-text search, and query optimization. Use when working with PostgreSQL, database design, or building data-intensive applications.
6home-assistant
Ultimate Home Assistant skill - complete administration, wireless protocols (Zigbee/ZHA/Z2M, Z-Wave JS, Thread, Matter), ESPHome device building, advanced troubleshooting, performance optimization, security hardening, custom integration development, and professional dashboard design. Covers configuration, REST API, automation debugging, database optimization, SSL/TLS, Jinja2 templating, and HACS custom cards. Use for any HA task.
6testing
Comprehensive testing skill covering unit, integration, and E2E testing with pytest, Jest, Cypress, and Playwright. Use for writing tests, improving coverage, debugging test failures, and setting up testing infrastructure.
5react-typescript
Build modern React applications with TypeScript. Covers React 18+ patterns, hooks, component architecture, state management (Zustand, Redux Toolkit), server components, and best practices. Use for React development, TypeScript integration, component design, and frontend architecture.
5power-automate
Expert guidance for Power Automate development including cloud flows, desktop flows, Dataverse connector, expression functions, custom connectors, error handling, and child flow patterns. Use when building automated workflows, writing flow expressions, creating custom connectors from OpenAPI, or implementing error handling patterns.
5mobile-pwa
Build Progressive Web Apps with offline support, push notifications, and native-like experiences. Covers service workers, Web App Manifest, caching strategies, IndexedDB, background sync, and installability. Use for mobile-first web apps, offline-capable applications, and app-like experiences.
5