This page serves as an index for the Blog Architecture Deep Dive series: a comprehensive exploration of how this blog is built, from high-level concepts to deep technical details.

About This Series

This series of articles explores the architecture of this blog in detail. We start from a layperson's perspective and progressively dive deeper into the technical implementation, design choices, and advanced features.

The series is designed to be read sequentially, with each article building on the previous ones. However, each article can also stand alone with references to related content.

Series Articles

1. Blog Architecture - Overview

Level: Layperson-friendly introduction

A high-level overview of what makes this blog different. Explains the core philosophy, key components, and what you get from this architecture. Perfect starting point for anyone curious about how the blog works.

Topics covered:

• What makes this blog different

• The core idea: write in Obsidian, publish automatically

• Why this approach

• Key components at a high level

• What you get from this architecture

2. Blog Architecture - Why Obsidian?

Level: Intermediate

Deep dive into why Obsidian was chosen as the authoring tool and how its unique features integrate with the web publishing system. Explores Obsidian's features, benefits, and how the integration works.

Topics covered:

• What is Obsidian?

• Why Obsidian for blogging

• How Obsidian integration works

• Obsidian-specific features

• Development workflow

• Benefits and trade-offs

3. Blog Architecture - From Markdown to Web

Level: Intermediate to Advanced

Explores the content processing pipeline: how Obsidian markdown files are transformed into web pages. Traces a file's journey from your Obsidian vault to a published blog post.

Topics covered:

• File discovery

• Metadata extraction

• Content processing (markdown to HTML)

• Link resolution

• Static generation

• Development vs production modes

4. Blog Architecture - Links and Navigation

Level: Intermediate to Advanced

Explores how Obsidian <span class="obsidian-link disabled" data-link="wiki links" title="Link to: wiki links (not yet created)">wiki links</span> become web navigation, how the content tree is built, and how users navigate the blog. Covers link resolution, tree building, and navigation features.

Topics covered:

• Wiki link resolution

• Three-tier matching strategy

• Content tree building

• Navigation features

• URL structure

• Navigation design philosophy

5. Blog Architecture - Build and Deployment

Level: Advanced

Explores the build process, static site generation, and deployment strategy. Covers how the blog is built, how it generates static pages, and how it's deployed to production.

Topics covered:

• Build process overview

• Copy blog content

• Generate embeddings

• Next.js build

• Optimization

• Deployment

• Build performance

6. Blog Architecture - Advanced Features

Level: Advanced

Explores the advanced features of the blog: semantic search, series organization, table of contents, and other sophisticated navigation and discovery mechanisms.

Topics covered:

• Semantic search

• Series organization

• Table of contents

• Linked posts

• Category system

• Image handling

• Performance optimizations

Reading Guide

For Beginners

Start with Blog Architecture - Overview to get a high-level understanding. Then read Blog Architecture - Why Obsidian? to understand the authoring experience. You can skip the more technical articles unless you're interested in implementation details.

For Developers

Read the series in order:

1. Overview (context)

2. Why Obsidian? (authoring experience)

3. From Markdown to Web (processing pipeline)

4. Links and Navigation (link resolution)

5. Build and Deployment (build process)

6. Advanced Features (advanced functionality)

For Specific Topics

• Want to understand Obsidian integration? → Blog Architecture - Why Obsidian?

• Curious about how markdown becomes HTML? → Blog Architecture - From Markdown to Web

• Interested in navigation? → Blog Architecture - Links and Navigation

• Need deployment info? → Blog Architecture - Build and Deployment

• Want to know about search and series? → Blog Architecture - Advanced Features

Related Content

• Blog Design - Overview of all blog design articles

• This Blog - Original detailed technical overview (comprehensive reference)

• Navigating Blog Content - User guide to navigation features

• About This Blog - General information about the blog

Series Navigation

• Start here: Blog Architecture - Overview

• Next: Blog Architecture - Why Obsidian?

• Previous: (This is the index)

• Last: Blog Architecture - Advanced Features

---

This is the index page for the Blog Architecture Deep Dive series. Start reading with Blog Architecture - Overview.