Pick the construct that matches the Markdown you expect. Each card shows the directive, the failure it rejects, and the smallest valid shape mediva wants instead.
blockThe recursive container for a heading plus prose or nested tags; presence and body rules target it.
<!-- mdv: block required minWords=20 noPlaceholder -->
## Summary
TODO
<!-- mdv: endblock --><!-- mdv: block required minWords=20 noPlaceholder -->
## Summary
The parser now validates generated Markdown before docs publish, so broken sections fail in CI.
<!-- mdv: endblock -->documentThe root marker for document-scope checks like title, truncation, fence wrappers, and LLM residue.
<!-- mdv: document title noLLMResidue noTruncation -->
Sure, here's the release note:
## TODO<!-- mdv: document title noLLMResidue noTruncation -->
# fix: validate release notes
The migration completed and every shard reported healthy.frontA marker for one YAML frontmatter field; attach required, oneof, pattern, or date rules to that key.
<!-- mdv: front status required oneof=draft,review,approved -->
---
status: maybe
owner: docs
---<!-- mdv: front status required oneof=draft,review,approved -->
---
status: review
owner: docs
---proseA free-prose region with no table, list, or checkbox structure; content rules still apply.
<!-- mdv: prose minWords=8 noPlaceholder -->
TBD
<!-- mdv: endprose --><!-- mdv: prose minWords=8 noPlaceholder -->
Describe the user-facing impact in plain language.
<!-- mdv: endprose -->listA bullet or numbered list constrained by item count and per-item word or evidence rules.
<!-- mdv: list minItems=2 each.minWords=3 -->
- tests
<!-- mdv: endlist --><!-- mdv: list minItems=2 each.minWords=3 -->
- parser fixtures passed
- CLI smoke test passed
<!-- mdv: endlist -->taskListA checkbox checklist of work items; pair with allChecked, minChecked, or maxChecked to gate completion.
<!-- mdv: taskList required allChecked exactLabels -->
- [x] Tests added or updated
- [ ] Docs updated
<!-- mdv: endtaskList --><!-- mdv: taskList required allChecked exactLabels -->
- [x] Tests added or updated
- [x] Docs updated
<!-- mdv: endtaskList -->evidenceListA list of verification items, reproduction steps, manual checks, or citations.
<!-- mdv: evidenceList required minItems=2 each.minWords=4 -->
- Looks fine
<!-- mdv: endevidenceList --><!-- mdv: evidenceList required minItems=2 each.minWords=4 -->
- Ran `npm test`; 412 pass, 0 fail.
- Checked the CI run; it is green.
<!-- mdv: endevidenceList -->choiceA single- or multi-select checkbox choice; oneChecked makes it single-select.
<!-- mdv: choice oneChecked -->
- [x] feat
- [x] fix
- [ ] docs
<!-- mdv: endchoice --><!-- mdv: choice oneChecked -->
- [ ] feat
- [x] fix
- [ ] docs
<!-- mdv: endchoice -->tableA Markdown table whose headers, row count, and named-column values can be checked.
<!-- mdv: table required cols=Area,Owner,Status minRows=1 -->
| Area | Status |
| ---- | ------ |
| Auth | done |
<!-- mdv: endtable --><!-- mdv: table required cols=Area,Owner,Status minRows=1 -->
| Area | Owner | Status |
| ---- | ----- | ------ |
| Auth | Dana | done |
<!-- mdv: endtable -->codeA fenced code block; checks language info strings and catches unclosed fences.
<!-- mdv: code required lang=ts codeFenceClosed -->
```
export const ok = true;
<!-- mdv: endcode --><!-- mdv: code required lang=ts codeFenceClosed -->
```ts
export const ok = true;
```
<!-- mdv: endcode -->mediaA visual evidence slot for screenshots or video; requiredOrNA accepts an explicit non-visual note.
<!-- mdv: media requiredOrNA -->
<!-- mdv: endmedia --><!-- mdv: media requiredOrNA -->
N/A: this change has no visual surface.
<!-- mdv: endmedia -->structure-atomsThe low-level shape rules: open a tag, close it with the matching end tag, and keep document order stable.
<!-- mdv: block required -->
## Summary
Ship the validator.
<!-- mdv: endtable --><!-- mdv: block required -->
## Summary
Ship the validator.
<!-- mdv: endblock -->