=== FEATURE-BLOCK-QUOTES.md ===
# FEATURE: Block Quotes
| Field | Value |
|-------------|-------|
| Version | 20260812 V1 |
| Description | Defines nested CommonMark block quote parsing and lazy continuation behavior. |
| Depends On | FEATURE-BLOCK-LEAF.md |
| Provides | block quote parser |
| Consumes | leaf block parser |
## Questions
- None.
## Behavior
The parser recognizes block quote markers with optional indentation and optional following whitespace. It supports nested block quotes, empty quotes, blank lines, quoted leaf blocks, and lazy continuation lines only when those lines continue paragraph content. Block quote boundaries remain distinct across blank lines.
## Programmatic Acceptance
=== AC block-quotes-conformance ===
Intent: The parser passes every supplied conformance example owned by the Block quotes section.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Block quotes$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC block-quotes-conformance ===
## User Acceptance
- None.
## Guardrails
- Block structure is resolved before inline structure.
- Lazy continuation does not absorb lines that begin a new block construct.
- Public Markdown implementations are not used.
=== END FEATURE-BLOCK-QUOTES.md ===
=== FEATURE-BLOCK-LISTS.md ===
# FEATURE: List Items and Lists
| Field | Value |
|-------------|-------|
| Version | 20260812 V1 |
| Description | Defines CommonMark bullet and ordered list parsing, nesting, and tightness metadata. |
| Depends On | FEATURE-BLOCK-LEAF.md, FEATURE-BLOCK-QUOTES.md |
| Provides | list parser |
| Consumes | leaf block parser, block quote parser |
## Questions
- None.
## Behavior
The parser recognizes bullet and ordered list markers with valid indentation and delimiter rules. It supports nested lists, empty items, continuation paragraphs, lazy continuation, indented content, block quotes and leaf blocks inside items, changing delimiters, ordered start numbers, and tight versus loose list classification. List structure takes precedence over inline interpretations where required by CommonMark.
## Programmatic Acceptance
=== AC list-items-conformance ===
Intent: The parser passes every supplied conformance example owned by list item parsing.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^List items$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC list-items-conformance ===
=== AC lists-conformance ===
Intent: The parser passes every supplied conformance example owned by list rendering and tightness rules.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Lists$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC lists-conformance ===
## User Acceptance
- None.
## Guardrails
- List markers must satisfy CommonMark indentation and delimiter rules.
- List tightness is determined from block structure and blank-line relationships.
- Public Markdown implementations are not used.
=== END FEATURE-BLOCK-LISTS.md ===
=== FEATURE-INLINE-ESCAPES.md ===
# FEATURE: Inline Escapes and Character References
| Field | Value |
|-------------|-------|
| Version | 20260812 V1 |
| Description | Defines CommonMark punctuation escapes and named and numeric character reference parsing. |
| Depends On | FEATURE-BLOCK-LISTS.md |
| Provides | escape parser, character reference parser |
| Consumes | block parser |
## Questions
- None.
## Behavior
The inline parser recognizes backslash escapes for ASCII punctuation, valid HTML named entities, decimal references, and hexadecimal references. Invalid Unicode scalar values and U+0000 become U+FFFD. References are unavailable in code spans and code blocks and cannot substitute for block or inline structural markers.
## Programmatic Acceptance
=== AC backslash-escapes-conformance ===
Intent: The parser passes every supplied conformance example owned by backslash escape parsing.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Backslash escapes$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC backslash-escapes-conformance ===
=== AC-character-references-conformance ===
Intent: The parser passes every supplied conformance example owned by entity and numeric character references.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Entity and numeric character references$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC character-references-conformance ===
## User Acceptance
- None.
## Guardrails
- Escapes do not activate syntax inside code spans, code blocks, autolinks, or raw HTML.
- Invalid character references produce literal text unless CommonMark requires replacement.
- Public Markdown implementations are not used.
=== END FEATURE-INLINE-ESCAPES.md ===
=== FEATURE-INLINE-CODE-BREAKS.md ===
# FEATURE: Inline Code Spans and Line Breaks
| Field | Value |
|-------------|-------|
| Version | 20260812 V1 |
| Description | Defines CommonMark code span normalization and hard and soft line break parsing. |
| Depends On | FEATURE-BLOCK-LISTS.md |
| Provides | code span parser, hard break parser, soft break parser |
| Consumes | block parser |
## Questions
- None.
## Behavior
The inline parser matches code span delimiters of equal length and normalizes line endings and paired boundary spaces according to CommonMark. It recognizes hard breaks from trailing spaces or a terminal backslash before a line ending, preserves soft breaks as line endings, and excludes block-final trailing break markers from hard-break output.
## Programmatic Acceptance
=== AC code-spans-conformance ===
Intent: The parser passes every supplied conformance example owned by code span parsing.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Code spans$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC code-spans-conformance ===
=== AC hard-line-breaks-conformance ===
Intent: The parser passes every supplied conformance example owned by hard line break parsing.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Hard line breaks$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC hard-line-breaks-conformance ===
=== AC soft-line-breaks-conformance ===
Intent: The parser passes every supplied conformance example owned by soft line break parsing.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Soft line breaks$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC soft-line-breaks-conformance ===
## User Acceptance
- None.
## Guardrails
- Code spans do not parse escapes, references, or line breaks as inline syntax.
- Hard breaks are recognized only within continuing blocks.
- Public Markdown implementations are not used.
=== END FEATURE-INLINE-CODE-BREAKS.md ===
=== FEATURE-INLINE-EMPHASIS.md ===
# FEATURE: Emphasis and Strong Emphasis
| Field | Value |
|-------------|-------|
| Version | 20260812 V1 |
| Description | Defines CommonMark emphasis and strong emphasis delimiter processing. |
| Depends On | FEATURE-INLINE-CODE-BREAKS.md |
| Provides | emphasis parser, strong emphasis parser |
| Consumes | block parser, code span parser |
## Questions
- None.
## Behavior
The inline parser computes delimiter runs and applies CommonMark left-flanking and right-flanking rules. It supports asterisk and underscore emphasis, strong emphasis, nesting, intraword restrictions, precedence with code spans, links, images, and HTML, literal excess delimiters, and the modulo-three constraints.
## Programmatic Acceptance
=== AC emphasis-conformance ===
Intent: The parser passes every supplied conformance example owned by emphasis and strong emphasis parsing.
Suite: scoped
Requires: executable=python3; scope=test
import subprocess
result = subprocess.run(
[
"python3",
"sources/spec_tests.py",
"--spec",
"sources/spec.txt",
"--program",
"./commonmark",
"--pattern",
r"^Emphasis and strong emphasis$",
],
capture_output=True,
text=True,
)
print(result.stdout)
print(result.stderr)
assert result.returncode == 0
=== END AC emphasis-conformance ===
## User Acceptance
- None.
## Guardrails
- Delimiter processing occurs after block structure and code-span boundaries are established.
- Underscore intraword emphasis remains prohibited where CommonMark prohibits it.
- Public Markdown implementations are not used.
=== END FEATURE-INLINE-EMPHASIS.md ===Run artifact