---
url: https://docs.w3id.org/rules/markdown.md
---

# Markdown rules

Rules for the README files in an identifier directory.

| Rule | Severity | What |
| --- | --- | --- |
| [`markdown/prefer-list-over-line-breaks`](./prefer-list-over-line-breaks) | notice | A stack of manual line breaks reads better as a list |

Whitespace and encoding in Markdown files are covered by the
[file format rules](../format/).

Back to the [rule catalogue](../).