# not-skg/notes architecture

> Architecture diagram of the GitHub repository not-skg/notes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/not-skg/notes
- Repository: https://github.com/not-skg/notes

## Overview

Quartz publishes Markdown notes as a static digital-garden website. The main flow is vault input through parsing and configured publication filters to page and asset emission; the generated site is then browsed through composed page layouts and interactive components. The graph also includes plugin stages, navigation/search capabilities, and shared build context. Relationships for unsampled subsystems are limited to wiring documented by the README or SOURCE INDEX; their internal behavior is not inferred.

Main entry points: [`quartz/build.ts`](https://github.com/not-skg/notes/blob/v4/quartz/build.ts) (Build orchestration), [`quartz/components/index.ts`](https://github.com/not-skg/notes/blob/v4/quartz/components/index.ts) (Component registry), [`quartz.config.ts`](https://github.com/not-skg/notes/blob/v4/quartz.config.ts) (Plugin configuration), [`quartz/processors/parse.ts`](https://github.com/not-skg/notes/blob/v4/quartz/processors/parse.ts) (Markdown parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Build pipeline"]
  node_build["Build orchestration<br/>[build.ts]"]
  node_parse["Markdown parsing<br/>[parse.ts]"]
  node_filter["Publication filters<br/>[filter.ts]"]
  node_emit["Site emission<br/>[emit.ts]"]
end

subgraph group_plugins["Content plugins"]
  node_pluginconfig["Plugin configuration<br/>[quartz.config.ts]"]
  node_transformers["Content transformers"]
  node_filters["Draft and explicit"]
  node_emitters["Page and asset emitters"]
  node_pluginresources["Plugin resources<br/>[index.ts]"]
end

subgraph group_site["Site rendering"]
  node_layout["Page layouts<br/>[quartz.layout.ts]"]
  node_componentregistry["Component registry<br/>[index.ts]"]
  node_pages["Content and listing pages"]
  node_explorer["Note explorer<br/>[Explorer.tsx]"]
  node_search["Site search<br/>[Search.tsx]"]
  node_graph["Link graph<br/>[Graph.tsx]"]
  node_backlinks["Backlinks<br/>[Backlinks.tsx]"]
end

subgraph group_shared["Shared runtime"]
  node_i18n["Translations<br/>[index.ts]"]
  node_context["Build context<br/>[ctx.ts]"]
  node_contentdata["Processed content<br/>[vfile.ts]"]
end

node_author(("Note author"))
node_vault["Markdown vault"]
node_siteoutput["Static website"]

node_author -->|"writes notes"| node_vault
node_vault -->|"publishes notes"| node_build
node_build -->|"invokes parsing"| node_parse
node_build -->|"invokes filtering"| node_filter
node_build -->|"invokes emission"| node_emit
node_parse -->|"applies transforms"| node_transformers
node_parse -->|"produces content"| node_contentdata
node_build -->|"loads configuration"| node_pluginconfig
node_pluginconfig -->|"configures"| node_transformers
node_pluginconfig -->|"configures"| node_filters
node_pluginconfig -->|"configures"| node_emitters
node_filter -->|"applies configured filters"| node_filters
node_emit -->|"loads plugin resources"| node_pluginresources
node_pluginresources -->|"exports emitter plugins"| node_emitters
node_emit -->|"writes site files"| node_siteoutput
node_layout -->|"selects components"| node_componentregistry
node_componentregistry -->|"registers page views"| node_pages
node_componentregistry -->|"registers explorer"| node_explorer
node_componentregistry -->|"registers search"| node_search
node_componentregistry -->|"registers graph"| node_graph
node_componentregistry -->|"registers backlinks"| node_backlinks
node_pages -->|"reads page metadata"| node_contentdata
node_explorer -->|"reads translations"| node_i18n
node_search -->|"reads translations"| node_i18n
node_build -->|"constructs build context"| node_context

click node_build "https://github.com/not-skg/notes/blob/v4/quartz/build.ts"
click node_parse "https://github.com/not-skg/notes/blob/v4/quartz/processors/parse.ts"
click node_filter "https://github.com/not-skg/notes/blob/v4/quartz/processors/filter.ts"
click node_emit "https://github.com/not-skg/notes/blob/v4/quartz/processors/emit.ts"
click node_pluginconfig "https://github.com/not-skg/notes/blob/v4/quartz.config.ts"
click node_transformers "https://github.com/not-skg/notes/tree/v4/quartz/plugins/transformers"
click node_filters "https://github.com/not-skg/notes/tree/v4/quartz/plugins/filters"
click node_emitters "https://github.com/not-skg/notes/tree/v4/quartz/plugins/emitters"
click node_pluginresources "https://github.com/not-skg/notes/blob/v4/quartz/plugins/index.ts"
click node_layout "https://github.com/not-skg/notes/blob/v4/quartz.layout.ts"
click node_componentregistry "https://github.com/not-skg/notes/blob/v4/quartz/components/index.ts"
click node_pages "https://github.com/not-skg/notes/tree/v4/quartz/components/pages"
click node_explorer "https://github.com/not-skg/notes/blob/v4/quartz/components/Explorer.tsx"
click node_search "https://github.com/not-skg/notes/blob/v4/quartz/components/Search.tsx"
click node_graph "https://github.com/not-skg/notes/blob/v4/quartz/components/Graph.tsx"
click node_backlinks "https://github.com/not-skg/notes/blob/v4/quartz/components/Backlinks.tsx"
click node_i18n "https://github.com/not-skg/notes/blob/v4/quartz/i18n/index.ts"
click node_context "https://github.com/not-skg/notes/blob/v4/quartz/util/ctx.ts"
click node_contentdata "https://github.com/not-skg/notes/blob/v4/quartz/plugins/vfile.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_build,node_parse,node_filter,node_emit toneBlue
class node_pluginconfig,node_transformers,node_filters,node_emitters,node_pluginresources toneAmber
class node_layout,node_componentregistry,node_pages,node_explorer,node_search,node_graph,node_backlinks toneMint
class node_i18n,node_context,node_contentdata toneRose
class node_author,node_vault,node_siteoutput toneIndigo
```

## Components

### Build pipeline

- [Build orchestration](https://github.com/not-skg/notes/blob/v4/quartz/build.ts): `quartz/build.ts`
- [Markdown parsing](https://github.com/not-skg/notes/blob/v4/quartz/processors/parse.ts): `quartz/processors/parse.ts`
- [Publication filters](https://github.com/not-skg/notes/blob/v4/quartz/processors/filter.ts): `quartz/processors/filter.ts`
- [Site emission](https://github.com/not-skg/notes/blob/v4/quartz/processors/emit.ts): `quartz/processors/emit.ts`

### Content plugins

- [Plugin configuration](https://github.com/not-skg/notes/blob/v4/quartz.config.ts): `quartz.config.ts`
- [Content transformers](https://github.com/not-skg/notes/tree/v4/quartz/plugins/transformers): `quartz/plugins/transformers`
- [Draft and explicit](https://github.com/not-skg/notes/tree/v4/quartz/plugins/filters): `quartz/plugins/filters`
- [Page and asset emitters](https://github.com/not-skg/notes/tree/v4/quartz/plugins/emitters): `quartz/plugins/emitters`
- [Plugin resources](https://github.com/not-skg/notes/blob/v4/quartz/plugins/index.ts): `quartz/plugins/index.ts`

### Site rendering

- [Page layouts](https://github.com/not-skg/notes/blob/v4/quartz.layout.ts): `quartz.layout.ts`
- [Component registry](https://github.com/not-skg/notes/blob/v4/quartz/components/index.ts): `quartz/components/index.ts`
- [Content and listing pages](https://github.com/not-skg/notes/tree/v4/quartz/components/pages): `quartz/components/pages`
- [Note explorer](https://github.com/not-skg/notes/blob/v4/quartz/components/Explorer.tsx): `quartz/components/Explorer.tsx`
- [Site search](https://github.com/not-skg/notes/blob/v4/quartz/components/Search.tsx): `quartz/components/Search.tsx`
- [Link graph](https://github.com/not-skg/notes/blob/v4/quartz/components/Graph.tsx): `quartz/components/Graph.tsx`
- [Backlinks](https://github.com/not-skg/notes/blob/v4/quartz/components/Backlinks.tsx): `quartz/components/Backlinks.tsx`

### Shared runtime

- [Translations](https://github.com/not-skg/notes/blob/v4/quartz/i18n/index.ts): `quartz/i18n/index.ts`
- [Build context](https://github.com/not-skg/notes/blob/v4/quartz/util/ctx.ts): `quartz/util/ctx.ts`
- [Processed content](https://github.com/not-skg/notes/blob/v4/quartz/plugins/vfile.ts): `quartz/plugins/vfile.ts`

### Other components

- **Note author**
- **Markdown vault**
- **Static website**

## Connections

- Note author → Markdown vault: writes notes (evidence: `README.md`)
- Markdown vault → Build orchestration: publishes notes (evidence: `README.md`)
- Build orchestration → Markdown parsing: invokes parsing (evidence: `quartz/build.ts`)
- Build orchestration → Publication filters: invokes filtering (evidence: `quartz/build.ts`)
- Build orchestration → Site emission: invokes emission (evidence: `quartz/build.ts`)
- Markdown parsing → Content transformers: applies transforms (evidence: `quartz/processors/parse.ts`)
- Markdown parsing → Processed content: produces content (evidence: `quartz/processors/parse.ts`)
- Build orchestration → Plugin configuration: loads configuration (evidence: `quartz/build.ts`)
- Plugin configuration → Content transformers: configures (evidence: `quartz.config.ts`)
- Plugin configuration → Draft and explicit: configures (evidence: `quartz.config.ts`)
- Plugin configuration → Page and asset emitters: configures (evidence: `quartz.config.ts`)
- Publication filters → Draft and explicit: applies configured filters
- Site emission → Plugin resources: loads plugin resources (evidence: `quartz/processors/emit.ts`)
- Plugin resources → Page and asset emitters: exports emitter plugins (evidence: `quartz/plugins/index.ts`)
- Site emission → Static website: writes site files (evidence: `quartz/processors/emit.ts`)
- Page layouts → Component registry: selects components (evidence: `quartz.layout.ts`)
- Component registry → Content and listing pages: registers page views (evidence: `quartz/components/index.ts`)
- Component registry → Note explorer: registers explorer (evidence: `quartz/components/index.ts`)
- Component registry → Site search: registers search (evidence: `quartz/components/index.ts`)
- Component registry → Link graph: registers graph (evidence: `quartz/components/index.ts`)
- Component registry → Backlinks: registers backlinks (evidence: `quartz/components/index.ts`)
- Content and listing pages → Processed content: reads page metadata (evidence: `quartz/components/pages/TagContent.tsx`)
- Note explorer → Translations: reads translations (evidence: `quartz/components/Explorer.tsx`)
- Site search → Translations: reads translations (evidence: `quartz/components/Search.tsx`)
- Build orchestration → Build context: constructs build context (evidence: `quartz/build.ts`)
