Obsidian Vault Organization#

This is your Obsidian vault for blog content. Open this folder in Obsidian to get started!

Folder Structure#

blog/
├── essays/          # Long-form, polished technical writing
├── thoughts/        # Short-form observations and quick ideas
├── drafts/          # Work-in-progress (won't be published)
└── .obsidian/       # Obsidian configuration

Content Types#

Essays (type: essay)#

• Purpose: In-depth technical articles, research writeups, tutorials
• Length: 500+ words, multiple sections
• Style: Polished, well-structured, carefully edited
• Examples: Research papers, technical deep-dives, explainers

Template:

---
title: "Your Essay Title"
description: "A brief summary (1-2 sentences)"
date: "2025-11-21"
type: essay
tags: ["research", "AI"]
draft: false
---

Your content here...

Thoughts (type: thought)#

• Purpose: Quick observations, connections, work-in-progress ideas
• Length: Short, often just a few paragraphs
• Style: Informal, conversational, unpolished is okay
• Examples: Quick insights, observations, questions

Template:

---
title: "Brief Title"
description: "One sentence summary"
date: "2025-11-21"
type: thought
tags: ["idea"]
draft: false
---

Your quick thought here...

Drafts#

• Any file in the drafts/ folder won't be published
• Or set draft: true in frontmatter

Writing Workflow#

Development Mode (Recommended)#

1. Start dev server: Run make dev from project root
2. Write in Obsidian: Your browser will be at http://localhost:8000
3. Save and refresh: Site auto-rebuilds, just refresh browser
4. Publish: Commit and push when ready

Using Templates#

Obsidian templates are in the templates/ folder:

• templates/essay-template.md - For long-form essays
• templates/thought-template.md - For quick thoughts

To use:

1. Enable Templates plugin in Obsidian (Settings → Core plugins)
2. Set template folder to templates (Settings → Templates → Template folder location)
3. Press Cmd/Ctrl+T to insert a template

Manual Build#

1. Create a new note in essays/ or thoughts/
2. Add frontmatter with type, title, date, etc.
3. Write using markdown with all Obsidian features:
   • [[wiki-links]] to other notes
   • [^sidenote: Margin notes!] for commentary
   • Code blocks, tables, images, etc.
4. Build: make build from the project root
5. Publish: Commit and push to GitHub

Obsidian Features#

• Graph view: See connections between your essays and thoughts
• Backlinks: Automatically track which notes reference each other
• Tags: Use #hashtags for additional organization
• Daily notes: Quick thoughts can start as daily notes

Tips#

• Don't overthink the essay/thought distinction — you can always change the type later
• Use thoughts liberally for work-in-progress ideas
• Promote thoughts to essays as they mature
• Link everything — the connections are valuable!