---
title: "Welcome"
tags: ["meta", "getting-started"]
published: true
---

# Welcome

This is your own gist — a quiet place for the things you keep, mangle, and remember. Every note lives in `notes/`, and every revision lives in git.

## How it works

- Drop a `.md` file into `notes/`. No folders, no config.
- Each note's frontmatter decides its fate:

```yaml
---
title: "My note"
date: 2026-08-26
tags: [ideas, code]
published: true   # false = secret notes stay off the index & search
---
```

- Run `make sync` to build the site and ship it to Cloudflare Pages.

## Everyday commands

```bash
make create NOTE="half-baked idea"   # publish a fresh note
make create NOTE="diary 2026" SECRET=1  # keep it unlisted
make sync                            # build + deploy
make serve                           # preview locally at :5173
```

> Good writing is rewriting. Good notes are version-controlled — git is the undo button.

Get started: edit this note, or `make create NOTE=your-first-note`.

> Tip: commit often. `git commit` is the real "save" — `make sync` just publishes what git remembers.