From 346bdcc27d8a5bb257240381540231ab0e798646 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Mon, 24 Aug 2026 12:32:53 +0200 Subject: [PATCH] Declare which errors/ file is required, floor the fence at three --- corpus/README.md | 3 ++- spec/flavour.md | 10 +++++----- 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/corpus/README.md b/corpus/README.md index 5510e21..722a3e3 100644 --- a/corpus/README.md +++ b/corpus/README.md @@ -8,7 +8,8 @@ One directory per contract kind: `combinations/`. - `normalization/` — `.md` + `.json`: markdown input, and the document `markdownToAdf` must build from it. One-way; the markdown is not canonical. -- `errors/` — `.md` + `.error`: markdown input that must not convert. +- `errors/` — `.md`: markdown input that must not convert. A `.error` beside it + pins which error. - `real-payloads/` — `.json`: sanitized live ADF, round-tripped ADF→markdown→ADF. No expected markdown. diff --git a/spec/flavour.md b/spec/flavour.md index 72ddebd..40cfbf7 100644 --- a/spec/flavour.md +++ b/spec/flavour.md @@ -23,8 +23,8 @@ normalizes to it through the round-trip. - Blockquotes prefix lines with `> `; a blank line inside a blockquote is a bare `>`. - ATX headings (`#` … `######`); setext input normalizes to ATX. - Code fences ``` with the node's language as info string, the fence lengthened past any backtick - run in the content — the longest run anywhere plus one, counting mid-line runs no closing fence - could match; indented-code input normalizes to fences. + run in the content — the longest run anywhere plus one, at least three, counting mid-line runs + no closing fence could match; indented-code input normalizes to fences. - Code spans: a backtick string one longer than the longest backtick run in the text, the text padded with one space on each side where it begins or ends with a backtick, or begins and ends with a space without being all spaces. The content is literal — inline parsing does not see @@ -38,9 +38,9 @@ normalizes to it through the round-trip. CommonMark autolink (absolute URI). - Paragraphs on one line — no soft wrapping; a soft line break in input becomes a single space. - Entity references in input decode to their characters; output backslash-escapes only where text - would otherwise parse as syntax: escape the leading delimiter of a construct that would otherwise - open, re-scan from there, and repeat — with the opener literal the closer parses as text, so - `*not emphasis*` is `\*not emphasis*`, one backslash. + would otherwise parse as syntax: escape the leading delimiter of a construct that would + otherwise open, re-scan from there, and repeat — with the opener literal the closer parses as + text, so `*not emphasis*` is `\*not emphasis*`, one backslash. - Blocks separated by one blank line, no trailing whitespace, single trailing newline; a document with no blocks is the empty string.