Skip to content
Obsidian Handbook
Vault setup
- Obsidan vault configuration is stored inside an
.obsidian/ folder at the
root of the vault; use this repo root as the vault and keep the config files
under .obsidian/ when ready.
Configuration Folder
- Vault metadata and storage rules are covered in the
Data Storage and
Backup docs; keep attachments in a
dedicated subfolder (see Attachments).
Notes & structure
- Files use Markdown and support
Obsidian-flavored syntax
plus advanced syntax (callouts,
folding, etc.).
- Use wiki links (
[[note-title]]) for internal references so every concept
connects in one graph; keep paths stable and prefer the note title as the
canonical link target. Links
- Add
aliases in frontmatter to capture alternate names, abbreviations, and
legacy titles so links resolve without fragmenting the graph.
Aliases
- Use the Backlinks, Outgoing links, and Graph view panes to audit
relationships, find orphaned notes, and validate the vault graph stays
connected. Backlinks,
Outgoing links,
Graph view
- Manage notes via backlinks, links, and aliases:
Manage Notes,
Links,
Aliases,
Embeds.
- Use Tags and
Properties for metadata; align with
Callouts and
Folding for readability.
Graph links
- Hub: [[readme.md]], [[sitemap.md]], [[graph-schema.md]]
- Tags:
#unfold/vault, #unfold/ops
Editing workflow
Vault management
- Keep vaults organized with the advice from
Manage Vaults and symbolic links via
the Symlinks doc if you share folders
between environments.
- Syncing notes or importing/exporting occurs through
Sync Notes and
Plugins/Importer references;
track web updates in Link Notes.
- Glossary for terminology: Glossary.
- Reinforce the graph-model inspiration from the
IPLD Primer; this structured
graph/linked-data view mirrors how the vault tracks folds, generator rules,
and schema mappings.