Pin the pipe-escape reading, enumerate the image gap, move the empty-key rule to §2

2026-08-24 09:30:27 +02:00
parent 1676da4725
commit af146a5425
4 changed files with 18 additions and 12 deletions
@@ -40,8 +40,9 @@ isAdfDocument(v: unknown): v is AdfDocument
  attributes.
 - Plain CommonMark is valid input to `markdownToAdf`, with two carve-outs — literal text
  matching directive or pipe-table syntax is claimed (escapable — `spec/flavour.md`) — and one
-  gap: an image title has no ADF home (an error result). Converting back yields the library's
-  canonical spelling, which round-trips byte-identically.
+  gap: a CommonMark image fits only as its own title-less paragraph; mid-text and titled images
+  are error results. Converting back yields the library's canonical spelling, which round-trips
+  byte-identically.
 - Foreign HTML maps a documented element set; an unmappable element is an error, never a silent
  drop. Well-formed HTML only — no tag-soup recovery.
 - The emitted formats are semver surface (AGENTS.md §8).