GEML Blocks Illustrated · The Simple Four

==== note {#outer}
Outer holds an inner block.
=== code {lang=sh}
echo hi
===
====                    %% longer outside, shorter inside: safe

=== note {#labeled}
A long block closed by a labeled fence.
=== #labeled            %% labeled close: no counting

=== note {#early}
This body contains a bare run of the opening length:
===                     ← same-length bare run: the block closes here
which closed the block above at that line.
=== #early              ← closes a block that is already closed

warning: labeled fence for `#early` at line 22, but block `#early`
  was already closed by a bare fence at line 20 — body may be
  silently truncated (line 22)
0 error(s), 1 warning(s)

$ geml list p1-fences.geml
#outer               note           L7-12
=== code             code     anon  L9-11
#labeled             note           L14-16
#early               note           L18-20   ← ends at L20
#fences-after-early  prose          L21-22   ← the two lines that fell out became prose

=== embed src=#f          ← attributes without {}: the whole line is a paragraph
This line follows a fence-like line that had no braces.

=== note {#open}
This block is never closed.  %% end of file

warning: line looks like an open fence for `embed` but is not one —
  attributes must be braced (`=== embed {…}`); the line reads as
  plain paragraph text (line 5)
error: unterminated `note` block (no matching === or `=== #open`) (line 8)
1 error(s), 1 warning(s)   exit 1

%% a top-level comment: kept in the file, never rendered

=== note {#hiddennote hidden}
Not rendered, but referenced: still checked.
===
=== note {#badattr foo=bar}
Unknown attribute on a known type.
===
=== fancy {#unknown}
An unknown type keeps its body raw: **not parsed**.
===
See [[#hiddennote]].

=== code {lang=ts}
export const x = 1;
%% this percent line is body text inside a raw block
===

=== meta
title = "Meta probe"
version = 3
draft = true
===
=== meta
title = "Second title"       ← same key: the later one is ignored
owner = "docs"
===

# Interpolation {#interp}

Version {{version}}, owner {{owner}}, escaped \{{version}}, code `{{version}}`.

Unknown {{nope}} key.

=== note {#cap caption="{{title}}"}
Attribute values are not interpolated.
===

warning: meta key `title` already defined at line 1; later
  definition at line 6 is ignored (line 6)
error: unknown metadata reference `{{nope}}` (line 15)

$ geml get p2-meta.geml '#meta'      ← the merged namespace
title = "Meta probe"
version = 3
draft = true
owner = "docs"

$ geml get p2-meta.geml '#meta["version"]'   GEP-0011
3

=== meta
title = "a"
===
=== meta
owner = "b"
===
=== note {#meta}          ← §4: with two or more meta blocks this is a reserved-id error
Declared #meta with two meta blocks.
===

error: `#meta` is reserved for this document's merged meta namespace, and this
  document has more than one `meta` block — give the block another id (line 7)

$ geml list p2b-reserved.geml
=== meta@61f06c79  meta  anon  L1-3
=== meta@0e8db6c1  meta  anon  L4-6
#meta              note        L7-9   ← one address: a reader sees a note, the processor sees the merge

$ geml check p2c-single.geml     a single meta carrying {#meta}: legal
ok: no diagnostics

=== math {#euler caption="Euler"}
e^{i\pi} + 1 = 0
===
Inline math $a^2+b^2=c^2$ stays inline; block math is the typed block.
Reference: [[#euler]].

==== note {#warn .warning caption="Careful"}
A callout with **inline** markup and a nested block:
=== code {lang=sh}
geml check doc.geml
===
==== #warn
Reference: [[#warn]].

=== text {#intro}
One paragraph of addressable prose.
===
=== text {#two}
First paragraph.

Second paragraph.
===
Projection of one paragraph: ![[#intro]]. Projection of two: ![[#two]].
Reference: [[#intro]].

error: `![[#two]]` projects inline content, but the target is not a
  single-paragraph `text` block; for block content use
  `=== embed {src=#two}` (line 28)