cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 馃崈
desertthunder.dev
charm
leaflet
readability
golang
1---
2title: Note Basics
3sidebar_label: Basics
4description: Creating notes, metadata, and storage model.
5sidebar_position: 2
6---
7
8# Note Basics
9
10## Creation
11
12**Quick note from command line**:
13
14```sh
15noteleaf note create "Meeting Notes" "Discussed Q4 roadmap and hiring plans"
16```
17
18**Interactive creation** (opens editor):
19
20```sh
21noteleaf note create --interactive
22```
23
24**From existing file**:
25
26```sh
27noteleaf note create --file ~/Documents/draft.md
28```
29
30**Create and immediately edit**:
31
32```sh
33noteleaf note create "Research Notes" --editor
34```
35
36## Structure
37
38Notes consist of:
39
40**Title**: Short descriptor shown in lists and searches. Can be updated later.
41
42**Content**: Full markdown text. Supports all standard markdown features including code blocks, lists, tables, and links.
43
44**Tags**: Categorization labels for organizing and filtering notes. Multiple tags per note.
45
46**Dates**: Creation and modification timestamps tracked automatically.
47
48**File Path**: Location of the markdown file on disk, managed by Noteleaf.
49
50## Storage
51
52**File Location**: Notes are stored as individual `.md` files in your notes directory (typically `~/.local/share/noteleaf/notes` or `~/Library/Application Support/noteleaf/notes`).
53
54**Naming**: Files are named with a UUID to ensure uniqueness. The title is stored in the database, not the filename.
55
56**Portability**: Since notes are plain markdown, you can read them with any text editor or markdown viewer.
57The database provides additional functionality like tagging and search, but the files remain standalone.