Numlex Documentation
Numlex is a native macOS notepad calculator. These guides cover installation and everyday use, the full sheet-language reference, and the catalogs behind conversions, formats and live data.
Reference pages document the app's main branch, pinned
to 1ebc752 (after R89):
docs/SYNTAX_REFERENCE.md
and
docs/SETTINGS_AND_APPEARANCE.md; released versions may differ. Install pages stay on released
behavior.
24 pages 20 syntax sections 2 pinned sources main @ 1ebc752
Start here
Using Numlex
Approachable guides to everyday use.- Natural calculations Arithmetic, percentages, money, dates and totals — plain lines that are checked live.
- Variables & functions Assign values with name = expression, reuse them anywhere, and call the built-in math functions.
- Units, currencies & weather Convert 237 built-in units, 166 live fiat currencies, and look up the weather for a place you type.
- Linked answers Turn any answer into a live token that other lines can reuse — change the source, everything follows.
- Sheets & files Named sheets, one-level folders, local storage, and .nlx import/export.
- Settings & appearance main The five Settings tabs — General, Editing, Numbers, Constants, Styling — and every appearance and formatting contract, including per-answer overrides, line highlights, the answer column and the line-number gutter.
Syntax Reference
The sheet language, documented from the main-branch reference.- Sheet language main How a sheet is written and evaluated: notation, line forms, names, strict versus quiet lines, and the total command.
- Numbers & integer bases main Decimal, grouped, scientific and compact literals, quick operators, and exact Int64 integer bases (hex, binary, octal).
- Operators & logic main Full precedence, arithmetic, comparisons, boolean logic (true short-circuit rules) and the exact Int64 bitwise lane.
- Built-in functions main All 23 math functions with arity, domains and examples, plus call syntax, nesting and argument separators.
- Percentages main Percent literals, additive vs multiplicative contexts, and every strict phrase pattern — including inverses and 'what %' forms.
- Money & rates main Currency markers, ISO annotation, named money values, time rates, and the strict phrase rules that never guess.
- Dates main The strict date grammar: months, relative days, durations, calendar semantics, output rules and errors.
- Units & quantities main Unit expressions, conversions, R84 quantity arithmetic, strict phrase patterns, cooking densities and custom units.
- Answer tokens main How live tokens are created and used: insertion rules, supported answers, unit conversion, copying and precision limits.
Reference
Catalogs, formats, live data and privacy.- Number formats & result display main The four regional presets, paste behavior, result display modes, and the r87 custom pattern grammar.
- Custom units & constants main Define your own units and app-wide constants: grammar, dependencies, limits and rejection rules.
- Live data & geography main Weather lookups, geocoding, distance (Haversine) and DMS/decimal degree syntax — with caching and privacy.
- Unit catalog main All 237 built-in non-currency units: ids, labels, explicit aliases, SI prefixes and dimensions.
- Currency reference main All 166 ISO 4217 fiat codes, named aliases, input markers, fractional digits and live-rate caching.
- Keyword index main Every syntax keyword by type — finite, contextual, free — plus what deliberately is not part of the syntax.
- Privacy & network main Local-first by design: what stays on your Mac, every network request the app can make, and how caching and fallbacks work.