From e989cc3edd6fc6dce98dde7fff7a4874c08e405f Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Sat, 12 Sep 2026 20:18:41 +0200 Subject: [PATCH] Name the pending CommonMark divergences and complete the spec attribution --- README.md | 5 +++++ corpus/README.md | 6 ++++-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 96f3b22..2507a25 100644 --- a/README.md +++ b/README.md @@ -115,6 +115,11 @@ emit refuses: library's canonical spelling, which round-trips byte-identically — where it converts back at all: a parse succeeding is no promise of that, so keep the source until the way back succeeds. `[a](/a\b)`, `` and `[a](/x y)` read cleanly and then refuse. +- Three CommonMark spellings parse without an error and build a document the reference renders + differently: `[](/url)` and `[]()` stay literal text against CommonMark's empty link, a list + continuing past a marker change stays one list against CommonMark's two, and a shortcut + reference matching its definition only under Unicode case folding stays unresolved. Each is + pinned `pending` in `corpus/commonmark-spec/exceptions.json`. - Raw HTML in markdown input is an error result, never a silent drop — a tag, a comment and a processing instruction alike. ADF holds no raw-HTML node; the element mapping ships at `0.3.0`. - Not every document converts back: `adfToMarkdown` is partial on valid ADF — a text node holding diff --git a/corpus/README.md b/corpus/README.md index 380c4d3..bc56709 100644 --- a/corpus/README.md +++ b/corpus/README.md @@ -20,5 +20,7 @@ One directory per contract kind, each landing with its milestone: milestone may close). JSON is editor-normal (AGENTS.md §2), two-space indent, keys sorted. `spec.json` is the vendored, -upstream machine-readable suite, byte-exact (CommonMark 0.31.2, CC-BY-SA-4.0, © John MacFarlane), -and is not re-serialized by the corpus gate. +upstream machine-readable suite, byte-exact from +[spec.commonmark.org](https://spec.commonmark.org/0.31.2/spec.json) (CommonMark 0.31.2, © John +MacFarlane, [CC-BY-SA-4.0](https://creativecommons.org/licenses/by-sa/4.0/)), and is not +re-serialized by the corpus gate.