Proposal 0013: CND 0.5.0 — rich text and block containers

[Maxanox]

Adds proposal 0013, the design for CND format 0.5.0. This is a redesign of the node model, not an addition.

What the proposal decides

• Rich text. Every prose slot becomes a RichText object: value, lang, standoff marks, and the four link families. The families move off the node base. Every offset indexes the text it sits beside.
• Marks. The known kinds are strong, emph, code, strike, sup, sub, underline, highlight and math; math carries its source in raw. Marks may overlap freely. They have a canonical form, with sorted order and same-kind marks merged. code and math marks are atomic.
• Block containers. List items, term definitions, table cells, quotes and footnotes hold block nodes in children. A nested list therefore has its own kind. quote, code and math become block-only.
• New elements:
  • admonition and layout nodes;
  • ListItem.checked;
  • figure.description;
  • code.title;
  • numbering {value, name}, which replaces number and counter_label;
  • table.kind (data / content / null), which replaces kind and content_kind;
  • doc.status, doc.version and doc.extra.
• Removed: tight, table.raw, quote.text, quote.lang, code.block and math.block.
• Cross-cutting rules:
  • open vocabularies (known values, free values, a defined fallback, no x- prefix);
  • no compatibility guarantee before 1.0.0;
  • hashing amendments: defaults dropped, nested nodes excluded, full position in the document hash;
  • traversal slots;
  • new validation invariants.
• Rendering: Markdown renders marks it has no syntax for as inline HTML by default, with a text-only option.

Proposal 0002 is superseded. The spec, schema, models and ADRs change in the implementation pull requests, cut into four plans: core; renderers and converters; declaration, builder and reconciliation; fixtures.

Closes CND-15

🤖 Generated with Claude Code

https://claude.ai/code/session_01XxXUiDn2QyzNTYnZpeVFVS