Guides Adding Content

Adding Content

Learn how to create and organize content in your digital garden

ContentBeginner

Prerequisites:

getting-started

ContentMarkdownFrontmatter

Content Basics

All content lives in the content/ folder as Markdown files with YAML frontmatter.

---
title: My First Note
description: A quick idea I captured
tags:
  - idea
  - design
status: seed
visibility: private
---

## The actual content

Write your content here using Markdown.

Base Fields (All Collections)

Every content file shares these fields:

Field	Required	Default	Description
`title`	Yes	-	Display title
`description`	No	-	Short summary
`tags`	No	`[]`	Categorization tags
`status`	No	`seed`	Lifecycle stage
`visibility`	No	`private`	Access control
`created`	No	-	ISO date string
`updated`	No	-	ISO date string

Status Lifecycle

Content grows through stages:

Status	Meaning
`seed`	New idea, rough draft
`sprout`	Developing, taking shape
`evergreen`	Mature, maintained
`wilted`	Outdated, needs review

Visibility Levels

Level	Who Can View
`private`	Only you (author) or admins
`internal`	Any logged-in user
`public`	Everyone

Collection-Specific Fields

Projects

---
title: UXLab
tech:
  - nuxt
  - tailwind
domains:
  - design-systems
outcome: "Ship v1.0 with auth and content management"
nextActions:
  - "Write deployment guide"
  - "Add search functionality"
waitingOn:
  - "Design review from team"
featured: true
---

Notes

---
title: Dashboard Ideas
relatedProjects:
  - uxlab
relatedPeople:
  - dan-mall
---

Tech Registry

---
title: Nuxt
slug: nuxt
kind: framework
icon:
  provider: iconify
  name: simple-icons:nuxtdotjs
website: https://nuxt.com
---

File Organization

content/
  projects/
    uxlab.md           # /projects/uxlab
    client-work/
      acme.md          # /projects/client-work/acme
  notes/
    2026-01-23-idea.md # Date-prefixed for chronology
  tech/
    nuxt.md            # Registry entries use slugs

Linking Content

Reference other content by slug:

# In a project
tech:
  - nuxt        # References content/tech/nuxt.md
  - tailwind    # References content/tech/tailwind.md
domains:
  - biopharma   # References content/domains/biopharma.md

Rich Media

Enhance your content with embedded media using MDC components:

Mermaid Diagrams - Flowcharts, sequence diagrams, ERDs
Video & Social Embeds - YouTube videos, Twitter/X posts

Tips

Start with notes - Capture ideas quickly, refine later
Use tags liberally - They power search and filtering
Keep slugs stable - Other content references them
Default to private - Make public intentionally