One inline worked example on a theory step or exercise (schema v1.5).
An inline example carries REAL content the learner reads in place —
a sample sentence (language lessons) or a code snippet with syntax
highlighting (programming lessons). This is DISTINCT from
LessonStep.example_url (#139 / schema v1.4), which links OUT to an
external illustration: example_url is the LINK variant,
examples is the INLINE-CONTENT variant. The two are complementary
and may coexist on the same theory step.
When language is set, content is treated as source code in
that language and rendered as a syntax-highlighted block (the same
CodeBlock the theory Markdown + code cards use); when it is
absent, content is plain text. Additive + optional, so content
without examples validates unchanged.
One inline worked example on a theory step or exercise (schema v1.5).
An inline example carries REAL content the learner reads in place — a sample sentence (language lessons) or a code snippet with syntax highlighting (programming lessons). This is DISTINCT from
LessonStep.example_url(#139 / schema v1.4), which links OUT to an external illustration:example_urlis the LINK variant,examplesis the INLINE-CONTENT variant. The two are complementary and may coexist on the same theory step.When
languageis set,contentis treated as source code in that language and rendered as a syntax-highlighted block (the sameCodeBlockthe theory Markdown + code cards use); when it is absent,contentis plain text. Additive + optional, so content withoutexamplesvalidates unchanged.