CLI reference
dither get
Read an entry by path or docid.
dither get <ref> [--lines start:end]Prints the body of a single entry to stdout. Resolves either a display path (the path under the configured library, e.g. notes/auth.md) or a qmd docid (e.g. #abc123). Refuses with the standard pre-init error until dither init has run.
Arguments
| Name | Description |
|---|---|
ref | Positional. Display path like notes/auth.md or docid like #abc123. Required. |
Flags
| Flag | Description |
|---|---|
--lines <start:end> | 1-based inclusive line range. Either side may be omitted: --lines 10: reads from line 10 to EOF; --lines :20 reads the first 20 lines. |
Examples
Whole file:
dither get notes/auth.mdBy docid (taken from a dither search hit):
dither get '#abc123'Lines 10 through 30:
dither get notes/auth.md --lines 10:30First 20 lines:
dither get notes/auth.md --lines :20Notes
- If the ref doesn't resolve, the command prints nothing and exits successfully. There is no "not found" error.
- Output is the raw markdown body, including frontmatter.
See also: CLI overview, dither search.