Reference

Celorga reference is split into two detailed sections:

For the independently implementable language standard, see SPEC.org, GRAMMAR.ebnf, and PARSING.org.

Live embed resolution

celorga embed resolve --target TARGET --file SOURCE [--dir CORPUS] [--json] is read-only. It returns org2:embed-resolution:v1 JSON containing a portable directive, title, resolved file, and source line, without copying source content. Targets are explicit id:STABLE-ID note/heading references or file:relative/path.org whole-note references; .org2 remains supported. Relative paths resolve from SOURCE. When --dir is omitted, the nearest org2.json defines the corpus, falling back to the source directory.

The shared app renderer interprets #+EMBED: TARGET keyword lines using compiled corpus IDs and source ranges. It rejects ambiguous IDs and out-of-corpus files, bounds cycles/depth/content, and renders source navigation beside read-only inline content. Ordinary HTML exports preserve references without resolving them; disclosure-safe publish document strips targets and emits an omission marker. See Live note and heading embeds for insertion, refresh, and limits.