GilLabs notes, talks, and experiments

How I Organize My Obsidian Vault

16 Sep 2026

I have been kind of addicted to taking notes ever since I started using computers heavily. I began with Tomboy, moved to Evernote, and later wrote .note files in Sublime Text using the PlainNotes plugin. Today, I use Obsidian.

Each change of tool also changed how I thought about my notes. What began as a place to save isolated pieces of information gradually became a collection of Markdown repositories for different parts of my life: software development, research, games, language study, writing, and general reference material.

The Extended Mind offers one way to understand this progression: a dependable external system can become part of how we remember and think.

This article tours that system as I actually use it. I will focus on the small set of conventions that connect notes, tasks, projects, and drafts. You can adapt those ideas without copying my directory tree or plugin setup.

Markdown Is the Foundation

Markdown gives me a durable base that works with text editors, command-line tools, Git, scripts, and coding agents. Obsidian provides the interface for navigating and editing the files, while the information remains usable outside the application.

I use frontmatter fields to add structured information such as dates, tags, status, and links. Obsidian renders these fields as Properties at the top of the note, where they are pleasant to read and easy to edit. In the Markdown file, they remain YAML that scripts and other tools can process.

After creating a note, I think about how I will locate it again. Tags provide broad categories, while a descriptive title that works well with fuzzy search gives the Quick Switcher useful words to match. I include the terms I am likely to remember months later.

Research behind Stuff I've Seen found that time and people are valuable retrieval cues, which is why dates and links to people also matter in my notes.

The note path provides one final retrieval clue by placing the file near related material. Those paths form the structure of my vault.

Vault Structure

A study comparing folders and tags found useful strengths in both, which fits my combination of directory paths and metadata.

Two established approaches helped me think about the choices in my own structure. Tiago Forte's PARA method organizes information by actionability into Projects, Areas, Resources, and Archives. Steph Ango's bottom-up approach keeps most notes in the root of a single vault and relies on links, backlinks, and the Quick Switcher for navigation, while a categories property generates overviews through Obsidian Bases.

My Structure

I keep one Obsidian vault containing several topic-focused directories. Each top-level directory is also an independent Git repository:

  • Dev: software development, tools, technical studies, projects, and GilLabs;
  • GameNotes: games, game design, jams, and game-development references;
  • GeneralNotes: everyday subjects, articles, people, places, and general reference material;
  • Languages: language-learning material and notes for each language;
  • ResearchNotes: papers, research projects, experiments, and academic writing;
  • StudyingNotes: study material that spans subjects outside the other repositories;
  • WritingNotes: fiction, writing projects, characters, settings, and related research;
  • OpenClawNotes: notes and tasks connected to OpenClaw. I give OpenClaw this directory as its workspace, limiting the files it is expected to modify and reducing the blast radius if an automated action goes off the rails.

This arrangement gives Obsidian access to the whole collection for search and linking, while each repository keeps its own Git history and project context.

Inside each repository, I mix subject-based and chronological organization. Stable topics live in descriptive directories. Time-sensitive notes and tasks often use year, month, and ISO-week folders. GilLabs, for example, has a backlog, weekly task notes, BrainS notes for developing ideas, and language-specific article drafts.

Links, metadata, search, and hub notes connect material across those directories. The main cost comes from maintaining several repositories and deciding when a subject deserves its own top-level space. I keep the boundaries that continue to make navigation and version history easier.

A Few Note Types with Different Jobs

  • Resource and reference notes hold sources and background material until I am ready to use them in an article, project, or decision.
  • BrainS notes, my mnemonic for exploratory idea notes, collect possible titles, incomplete arguments, examples, questions, and competing outlines.
  • Task notes record status, priority, sources, subtasks, acceptance criteria, and a timeline of decisions and progress.
  • Draft notes contain reader-facing text and link back to their planning tasks. Separate language versions share metadata.

Backlogs, Daily Notes, and Timelines

Task frontmatter stores status, priority, deadlines, and backlog links. Dataview uses those fields to generate current backlog tables.

I published my Dataview backlog template as a gist, with views for progress and active, completed, and dropped tasks.

Daily notes preserve chronological context, while task timelines record what happened to a specific piece of work. Links between them help me resume a project after an interruption.

Memory for Goals models how cues help us retrieve suspended goals.

Templates

Templates give recurring notes predictable frontmatter and headings. Small scripts can place a note in the correct week, update metadata, build the blog, or check links. I wait for a pattern to repeat before automating it so the workflow has time to settle. Git records the resulting changes and makes larger automated edits reviewable, while backups and synchronization provide additional recovery options.

Closing

When I reopen an old idea months later, I can usually understand where I stopped and what to do next without rebuilding its context from scratch.

I plan to cover how I use Obsidian for language study and how notes become multilingual GilLabs posts in separate articles. Those workflows use the same foundation, but they solve narrower problems.