Semantic role: abstract. Compiles to eHTML <abstract>.

Registers:

• Canonical: <abstract>

<abstract |
This paper presents new evidence that elephant populations
significantly affect regional climate patterns through their
role in shaping vegetation and carbon storage.
>

Unstructured abstract (the default). Single paragraph of summary prose.

<abstract type=structured |
**Background:** Elephant populations have declined significantly.

**Methods:** We surveyed 50 forest sites over 10 years.

**Results:** Decline correlates with vegetation loss.

**Conclusion:** Conservation efforts are essential.
>

Structured abstract using markdown bold for section headings. Common in medical and scientific journals. The structure is visible in the rendered output via the bold prefixes.

<abstract word-limit=250 |
This paper presents...
>

Semantic role: affiliation. Compiles to eHTML <affiliation>.

Registers:

• Canonical: <affiliation>

<author>
  <name | Jane Goodall>
  <affiliation | Anthropic>
</author>

Simple author affiliation. The affiliation sits as a sub-element of <author>, parallel to other rich-author-metadata elements (<orcid>, <email>).

<author>
  <name | Jane Goodall>
  <affiliation #aff1 | Anthropic, San Francisco, USA>
</author>
<author>
  <name | David Attenborough>
  <affiliation #aff1 />
</author>

Shared affiliation. The id on the first affiliation lets subsequent authors reference the same one by id via a self-closing tag. JATS exporter generates the appropriate <xref ref-type=”aff” rid=”aff1”> structure.

Semantic role: article-subtitle. Compiles to eHTML <article-subtitle>.

Registers:

• Canonical: <article-subtitle>

Semantic role: article-title. Compiles to eHTML <article-title>.

Registers:

• Canonical: <article-title>

Semantic role: author. Compiles to eHTML <author>.

Registers:

• Canonical: <author>

Backward-compatible casual form (carried forward from before the structured-interface reconciliation). The pipe content sits as text content of <author>; it is NOT lifted to a <name> child — authors who want the structured shape use the kwarg form below or the child-tag form. JATS export reads the name string either way.

Kwarg form. Each lifted kwarg becomes a child tag at the gate; +corresponding stays as a boolean kwarg on the canonical eHTML <author>.

<author +corresponding>
  <name | Jane Goodall>
  <affiliation | Cambridge University>
  <orcid | 0000-0001-2345-6789>
  <email | jane@example.com>
</author>

Child-tag form. The canonical eHTML shape. Both this form and the equivalent kwarg form above produce the same eHTML output.

<meta>
  <author | Jane Goodall>
  <author | David Attenborough>
  <author +corresponding | Charles Darwin>
</meta>

Multiple authors are sibling <author> elements inside <meta>. The third is the corresponding author. JATS export groups them as <contrib-group>.

Semantic role: book-part-subtitle. Compiles to eHTML <book-part-subtitle>.

Registers:

• Canonical: <book-part-subtitle>

Semantic role: book-part-title. Compiles to eHTML <book-part-title>.

Registers:

• Canonical: <book-part-title>

Semantic role: book-subtitle. Compiles to eHTML <book-subtitle>.

Registers:

• Canonical: <book-subtitle>

Semantic role: book-title. Compiles to eHTML <book-title>.

Registers:

• Canonical: <book-title>

Semantic role: config. Compiles to eHTML <config>.

Registers:

• Canonical: <config>

The authoring form for <config> is kwargs. Settings are read at the discovery pass into the configuration registry; the element itself produces no body output (it renders as an empty <config>).

More operational options, all from the live kwarg allowlist (citation-style, number-sections, number-figures, number-tables, number-equations, show-source, parse-data-tables, ref-prefix-).*

Semantic role: date. Compiles to eHTML <date>.

Registers:

• Canonical: <date>

A bare <date> is UNTYPED (no data-date-type) — an authoring date is “when you wrote it” (like the date on a letter), not a publication date (cf. Quarto/Pandoc/Bookdown preamble date slots). Use an explicit type= (e.g. <date type=publication | …>) for a typed date. (#325)

<meta>
  <date type=submission | 2023-11-01>
  <date type=acceptance | 2024-02-10>
  <date type=publication | 2024-03-15>
</meta>

Multiple dates of different types. The publication date is the primary; submission, acceptance, etc., go in JATS history.

Free-form date format. Acceptable but ISO 8601 is preferred for machine readability and for predictable JATS export.

Semantic role: editor. Compiles to eHTML <editor>.

Registers:

• Canonical: <editor>

Casual form — the pipe content is the editor’s name (text content, not lifted to a <name> child), mirroring <author | …>.

Kwarg form. name / affiliation / orcid / email lift to child tags at the gate (unified to <author>’s shape, #338); role stays a scalar attribute (data-role) — the one field that differs from <author>.

Semantic role: email. Compiles to eHTML <email>.

Registers:

• Canonical: <email>

<author>
  <name | Jane Goodall>
  <email | jane@example.org>
</author>

Author contact email. Common in journal article metadata for the corresponding author (see also the +corresponding boolean kwarg on <author>).

Semantic role: keywords. Compiles to eHTML <keywords>.

Registers:

• Canonical: <keywords>

<meta>
  <keywords | elephants, conservation, climate, carbon storage>
</meta>

Comma-separated keyword list — the simpler and more common authoring form. The exporter splits on commas when emitting JATS.

Kwarg-form authoring lifts to the child-tag form at the gate.

Semantic role: lang. Compiles to eHTML <lang>.

Registers:

• Canonical: <lang>

<meta>
  <lang | en-US>
</meta>

BCP 47 language tag. The eHTML form preserves the value as a child element of <meta>; downstream consumers (the JATS exporter, the render-mode lowering) project it where each format expects.

Kwarg-form authoring lifts to the child-tag form at the gate.

Semantic role: license. Compiles to eHTML <license>.

Registers:

• Canonical: <license>

<meta>
  <license href="https://creativecommons.org/licenses/by/4.0/" | CC BY 4.0>
</meta>

License name with canonical URL.

Kwarg-form authoring (license name only) lifts to the child-tag form at the normalize-to-canonical gate.

Semantic role: meta. Compiles to eHTML <meta>.

Registers:

• Canonical: <meta>

<meta type=article>
  <title | The Effect of Elephants on Climate>
  <author | Jane Goodall>
  <date | 2024-03-15>
</meta>

<section | Introduction>
The paper begins.

*Author writes <meta type=article> at the top with no <article> wrapper. The structural plugin reads type=article and generates:

• the <article> container
• <article-front> wrapping the original <meta>
• <article-body> wrapping the section content <title> is promoted to <article-title> as the first child of <meta>. <meta> itself survives in the output, inside <article-front>.*

<meta type=book>
  <title | A Natural History of Elephants>
  <author | Jane Goodall>
</meta>

<chapter | Origins>
Content.

type=book generates the book-shaped wrapper instead. Changing the single kwarg switches the entire output structure. Each book-part contains its own <meta> with <book-part-title>; no <book-part-meta> wrapper.

Semantic role: name. Compiles to eHTML <name>.

Registers:

• Canonical: <name>

<author>
  <name | Jane Goodall>
</author>

The common case. Pipe content becomes the name string.

Kwarg form of <author>. The name kwarg lifts to a <name> child tag at the normalize-to-canonical gate, parallel to <meta>’s kwarg-to-child-tag lift. The +corresponding boolean stays as a kwarg/attribute on the canonical eHTML <author> (it is a scalar marker, not a structured field).

Semantic role: orcid. Compiles to eHTML <orcid>.

Registers:

• Canonical: <orcid>

<author>
  <name | Jane Goodall>
  <orcid | 0000-0002-1825-0097>
</author>

Bare 16-digit ORCID — the canonical form.

<author>
  <name | Jane Goodall>
  <orcid | https://orcid.org/0000-0002-1825-0097>
</author>

URL form is accepted but bare form is preferred.

Semantic role: publication-date. Compiles to eHTML <publication-date>.

Registers:

• Canonical: <publication-date>

<meta>
  <publication-date | 2024-03-15>
</meta>

ISO 8601 publication date — the preferred form.

<meta>
  <publication-date | March 15, 2024>
</meta>

Free-form publication date. Acceptable but ISO 8601 is preferred for predictable JATS export and machine readability.

Semantic role: section-subtitle. Compiles to eHTML <section-subtitle>.

Registers:

• Canonical: <section-subtitle>

Semantic role: section-title. Compiles to eHTML <section-title>.

Registers:

• Canonical: <section-title>

Semantic role: sub-section-subtitle. Compiles to eHTML <sub-section-subtitle>.

Registers:

• Canonical: <sub-section-subtitle>

Semantic role: sub-section-title. Compiles to eHTML <sub-section-title>.

Registers:

• Canonical: <sub-section-title>

Semantic role: sub-sub-section-subtitle. Compiles to eHTML <sub-sub-section-subtitle>.

Registers:

• Canonical: <sub-sub-section-subtitle>

Semantic role: sub-sub-section-title. Compiles to eHTML <sub-sub-section-title>.

Registers:

• Canonical: <sub-sub-section-title>

Semantic role: subject. Compiles to eHTML <subject>.

Registers:

• Canonical: <subject>

<meta>
  <subject | Ecology of large mammals>
</meta>

Free-form subject. Common for general-interest documents.

<meta>
  <subject scheme=MSC2020 | 92D40>
  <subject scheme=MSC2020 | 92D25>
</meta>

Multiple subjects from a controlled vocabulary. The scheme identifies the classification system; the JATS exporter generates the appropriate <subj-group subj-group-type=”…”> wrapper.

Semantic role: subtitle. Compiles to eHTML <subtitle>.

Registers:

• Canonical: <subtitle>

<meta>
  <title | The Effect of Elephants on Climate>
  <subtitle | A Multi-Year Field Study in Tanzania>
</meta>

Semantic role: title. Compiles to eHTML <title>.

Registers:

• Canonical: <title>

<meta>
  <title | The Effect of Elephants on Climate>
</meta>

Inside <article>, <title> in <meta> becomes <article-title>.

<book>
  <meta>
    <title | A Comprehensive Guide>
  </meta>
</book>

Inside <book>, <title> in <meta> becomes <book-title>.

<meta>
  <title | The role of <i type=taxonomic | Loxodonta africana> in ecosystem dynamics>
</meta>

Titles can contain inline elements. The recursive content parsing handles nested constructs.

Semantic role: version. Compiles to eHTML <version>.

Registers:

• Canonical: <version>

<meta>
  <version | 1.0.0>
</meta>

Semantic version. Other formats are equally valid as a free-form string.

Kwarg-form authoring lifts to the child-tag form at the gate.