Z520: MALFORMED_LIST_DETECTED¶

Severity: Error

Penalty: 0.0 points | Category: general
Remediation & Opt-In

Auto-Fixable: No | Opt-In: No

Description¶

A paragraph contains 3 or more consecutive lines separated by hard newlines that end with list-like punctuation (such as semicolons ; or commas ,) but lack proper Markdown list markers (-, *, 1.).

Screen readers and Markdown renderers treat these blocks as an unbroken prose run rather than a structured HTML list (<ul> / <ol>), harming accessibility and document hierarchy.

How to Fix¶

Prefix each line with a Markdown bullet - or number 1., separating the list from surrounding prose with a blank line:

<!-- Before (Malformed List) -->
Zenzic provides:
Link verification;
Security secret scanning;
Deterministic quality scoring;

<!-- After (Semantic Markdown List) -->
Zenzic provides:

- Link verification;
- Security secret scanning;
- Deterministic quality scoring;

Automated Remediation¶

Fix all malformed lists across your workspace using the Zenzic atomic mutator:

zenzic fix --apply

Suppression¶

Suppress an intentional list-like paragraph with an inline comment:

<!-- zenzic:ignore:Z520 -->

Reference¶

See the Finding Codes Index for finding code details.