1 Cordial Modules
jess edited this page 2026-04-15 09:38:07 -07:00

Cordial Modules

Boundaries

Marker Effect
# Heading (H1) Root module — auto-imports into every other module
## Heading (H2) Closes current, starts a new named module
--- (HR) Closes current, starts an unnamed module
### Heading (H3) Does not split
#### Heading (H4) Does not split

Naming

H2 heading text → module name, lowercased and snake-cased.

## Trig Helpers

Module name: trig_helpers.

Unnamed modules auto-name from the first fn or let, or _unnamed_N.

use

use trig_helpers
use trig_helpers::deg_to_rad
use trig_helpers::*

Resolved via topological sort. Cycles fall back to evaluation without the cyclic dependency.

Cross-block table references

Heading above a table Visibility
### Budget (H3) Global
#### Budget (H4) Local to owning module
@trig_helpers::Lookup:A1

Positional fallbacks:

@table_1
@table_3:B2
@my_module::table_2

Naming conventions

Element Form
Note titles (filenames) hyphen-form: my-note.md
Block / module titles snake_form: ## Trig Helpers
Unnamed blocks block_N / _unnamed_N

See also