Table row with more cells than the header

table-row-overflowon by defaultJapanese / English

A table row with more cells than the header row (the extra ones are not shown)

Example

Flagged

| Item | Cost | | --- | --- | | Venue | $500 | | Food | $300 | includes reserve |

What chaff prints

4:1 This row has 3 cells; past the header's 2 columns they are not shown

Fixed

| Item | Cost | Note | | --- | --- | --- | | Venue | $500 | | | Food | $300 | includes reserve |

What chaff prints

no finding

How to fix

Add the column to the header row, or remove the extra cell. Write a "|" inside a value as "\|".

Why it matters

A Markdown table (GFM) shows only as many cells as its header row has, and silently drops the rest. It happens when a value holds a "|", or when a column was added to the rows but not to the header, and the reader never sees the value that was written.

What it does not flag

A row with fewer cells than the header (shown as empty cells), a value written with "\|", and tables in code or quotations are not reported.

Turning it off or relaxing it

Silence this one spot (in the document)

Relax it for the team (the reason is kept as a comment in chaff.yaml)

npx chaffjs relax table-row-overflow --why "reason"

Turn it off for the team (chaff.yaml)

rules: table-row-overflow: off

Technical details

Layer: L1
Status: stable
Severity: warning
Languages: Japanese and English
Suited to: business, technical, blog, legal, docs, academic, literature, speech
Reads from the document: markdown

Levels

Set a level for this rule under rules in chaff.yaml. With nothing set, it runs at the level its genre gives it (see By genre below).

strict	error
normal	warning
relaxed	info

This rule has no limit to count to. A level sets how a finding is marked: relaxed keeps the finding and marks it a step lower.

By genre

Runs by default in: technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript

Genres

Message

This row has {cells} cells; past the header's {columns} columns they are not shown

Rewrite depth (chaff fix-plan --depth): light — words and sentences; the structure and the voice stay

This page is built from the rule's definition file:packages/chaff/rules/table-row-overflow.yaml