CND 0.5.0 renderers and converters: inline layer, Markdown, HTML

[Maxanox]

Ports everything that renders a CND to format 0.5.0, following proposal 0013. This is plan 2 of the series on the format-0-5-0 integration branch.

What changes

• One inline layer (cnd.core.inline) turns rich text into Markdown, HTML or plain text:
  • it nests the marks, and splits a mark where two cross;
  • it judges each Markdown delimiter on the rendered content, and falls back to an HTML tag (or to plain text under text_only) when a delimiter would not parse.
• Markdown rendering:
  • marks without a Markdown syntax (sup, sub, underline, highlight) become inline HTML by default, and plain text with the new text_only option;
  • GitHub-style alerts for admonitions, and task-list checkboxes;
  • code titles and figure descriptions;
  • lists that are tight or loose depending on their content;
  • tables rendered as GFM, as an HTML block, or as linearized rows under text_only;
  • layouts flattened.
• HTML rendering: <aside> admonitions, CSS-grid layouts, checkboxes, nested ordered lists (the old renderer always wrote <ul>), and <meta> tags for the document's status, version and extra metadata.
• Converters:
  • container content renders exactly once;
  • each block's marker line gathers the edges of every text inside it;
  • footnotes hold blocks, and bibliography entries are rich text;
  • status, version and extra go into the Markdown front matter.
  • A heading nested inside a container or a footnote keeps its section.
• Goldens are regenerated, and a new elements golden covers every 0.5 element. Each golden diff is explained by a 0.5 decision.

tests/conftest.py now parks only the six modules that plan 3 ports: builder, CLI, declaration, display visitor, reconciliation and visitor.

Review

• Every task had its own review, and one task needed a fix round: the Markdown marker line now sits apart from container blocks.
• The final whole-branch review found three defects, all fixed in this branch:
  • a heading nested in a container lost its section;
  • a prefix written before a code block broke the Markdown;
  • delimiters were judged on the wrong characters.
• The suite passes with 561 tests.
• Follow-ups: CND-36 (hyperlinks in HTML) and CND-37 (smaller hardening items).

Part of CND-27

🤖 Generated with Claude Code

https://claude.ai/code/session_01XxXUiDn2QyzNTYnZpeVFVS