10 - referenced content leaves a note naming it

2026-09-25 18:49:19 +02:00
parent 0644d1bc5d
commit 3fce43e884
2 changed files with 13 additions and 5 deletions
@@ -36,8 +36,9 @@ In priority order.
   form carries only what CommonMark cannot hold.
 5. **Lossy conversion keeps the content.** `adfToPlainMarkdown` and `plainMarkdownToAdf` drop what
   plain markdown cannot hold — format, design, structure — never content: what a reader of the
-   rendered document sees or follows, its text, images and link targets. What is dropped goes the
-   way the audience expects.
+   rendered document sees or follows, its text, images and link targets. Content the document only
+   references is marked where it stood, by a note that reads as the converter's and names what was
+   left out. What is dropped goes the way the audience expects.
 6. **Failures are values.** Nothing throws, and `code` is a closed list — as much a contract as
   the emitted formats are.
 7. **Nothing in the way.** No runtime dependencies, no I/O, no configuration, no host API: ESM on