Problem
The Markdown linting rule MD013 enforces a 120-character line length limit, which is overly restrictive for device
documentation pages. This creates readability and formatting issues:
-
Technical descriptions: Complex sentences describing hardware features, pin functions, and specifications
naturally exceed 120 chars and cannot be meaningfully broken into shorter lines without creating awkward sentence
fragments.
-
Table entries: GPIO pinout tables and other structured data often have long descriptive text that cannot be
wrapped without breaking table formatting.
-
URLs and code references: Links to documentation and code examples frequently exceed
the limit when included in sentences.
-
Maintainability: The restriction forces artificial line breaks that make the markdown source harder to edit
and maintain without providing any real readability benefit in the rendered HTML.
Suggested Solution
Disable MD013 for device documentation files.
Current Behavior
Device page validation rejects otherwise well-written documentation solely because lines exceed 120 characters.
Expected Behavior
Device pages should pass validation if they follow all other style guidelines, regardless of line length (within reason).
URL
https://devices.esphome.io/
Additional information
No response
Problem
The Markdown linting rule MD013 enforces a 120-character line length limit, which is overly restrictive for device
documentation pages. This creates readability and formatting issues:
Technical descriptions: Complex sentences describing hardware features, pin functions, and specifications
naturally exceed 120 chars and cannot be meaningfully broken into shorter lines without creating awkward sentence
fragments.
Table entries: GPIO pinout tables and other structured data often have long descriptive text that cannot be
wrapped without breaking table formatting.
URLs and code references: Links to documentation and code examples frequently exceed
the limit when included in sentences.
Maintainability: The restriction forces artificial line breaks that make the markdown source harder to edit
and maintain without providing any real readability benefit in the rendered HTML.
Suggested Solution
Disable MD013 for device documentation files.
Current Behavior
Device page validation rejects otherwise well-written documentation solely because lines exceed 120 characters.
Expected Behavior
Device pages should pass validation if they follow all other style guidelines, regardless of line length (within reason).
URL
https://devices.esphome.io/
Additional information
No response