Wiki Format

Wiki Page Format (Quartz Compatible)

Frontmatter

All Wiki pages MUST include this frontmatter:

---
title: Page Title
date: YYYY-MM-DD
tags:
  - tag1
  - tag2
publish: true
---

• title: Human-readable, title case
• date: ISO 8601, date of creation or last significant update
• tags: lowercase, hyphenated. Concept-based (what it IS, not what it’s ABOUT)
• publish: true: always true for Wiki pages

Concept Page Structure

---
title: Concept Name
date: YYYY-MM-DD
tags:
  - relevant-tag
publish: true
---
 
One-sentence definition.
 
## Overview
 
3-5 paragraphs. What it is, the problem it addresses, and where it fits in
the broader landscape. Must be understandable WITHOUT reading the source.
 
## Background
 
How it emerged, prior approaches, and why it matters. Provide context a
reader needs to understand the rest of the page.
 
## How It Works
 
The mechanism, architecture, or components — explained in depth. Use
subheadings (`###`) for distinct parts. Include concrete detail, not just
high-level summary.
 
## Key Ideas
 
Detailed bullets — each point gets a sentence or two of explanation, not a
bare phrase.
 
- **Point** — explanation.
 
## Examples / Use Cases
 
Concrete examples or applications drawn from the source.
 
## Limitations / Considerations
 
Caveats, trade-offs, or open questions (only if the source supports them).
 
## Related Concepts
 
- [[RelatedConcept1]]
- [[RelatedConcept2]]
 
## Sources
 
- [[sources/source-title]]

Adapt sections to the material: include those that apply, omit those the source cannot support. Depth comes from the source — never pad or invent.

Source Summary Page Structure

---
title: Source Title
date: YYYY-MM-DD
tags:
  - tag1
publish: true
---
 
**Type:** Paper / Book / Article / Video
**Author:** Author Name
**Original Date:** YYYY-MM-DD
 
## Summary
 
3-5 paragraph summary covering the source's main argument, structure, and
conclusions.
 
## Key Insights
 
Detailed bullets — each insight explained in a sentence or two.
 
- **Insight** — explanation.
 
## Details / Notable Points
 
Specific facts, figures, methods, or quotes worth preserving from the source.
 
## Related Wiki Pages
 
- [[Category/ConceptPage]]

Index Page Structure

---
title: Folder Name
publish: true
---
 
One-sentence description of this category.
 
## Pages
 
- [[PageName1|Page Title 1]]
- [[PageName2|Page Title 2]]
 
## Subcategories
 
- [[Subcategory/index|Subcategory Name]]

Wiki Catalog (1.Wiki/index.md) Structure

---
title: Wiki
publish: true
---
 
# Wiki
 
Central catalog of all knowledge pages.
 
## Categories
 
- [[Category1/index|Category1]] — one-line description
- [[Category2/index|Category2]] — one-line description
 
## Recent Updates
 
- [[Category/Page]] — YYYY-MM-DD

Log (1.Wiki/log.md) Structure

Append-only. Each entry:

## YYYY-MM-DD — Source Title
 
- **Action:** Created / Updated
- **Pages affected:** [[Category/Page1]], [[Category/Page2]]
- **Summary:** One sentence about what changed.

Linking Rules

• Internal links: [[PageName]] (Obsidian wikilink, shortest path)
• With alias: [[PageName|Display Text]]
• Backlinks are auto-generated by Quartz — do NOT manually add backlink sections
• Never use relative markdown links ([text](../path.md))

File Naming

• Pages: kebab-case.md (e.g., transformer-architecture.md)
• Folders: PascalCase (e.g., MachineLearning/)
• Source summaries: kebab-case.md matching source title