Skip to content

MD060 - table-column-style

Description

This rule checks that table column separator pipe characters (|) are used consistently. It supports three styles: aligned where pipes are vertically aligned (using visual width for CJK/emoji characters), compact with single space around content (empty cells may use a single space), and tight with no padding. The any style accepts any consistent style.

Rationale

Consistent formatting makes it easier to understand a document. Well-formatted tables are easier to read and maintain.

Configuration

style

Required table column style.

  • Default: any
  • Options:
    • any: Allow any consistent style (reports fewest violations)
    • aligned: Pipes must be vertically aligned
    • compact: Single space around cell content
    • tight: No padding around cell content
aligned_delimiter

Require delimiter row pipes to align with header.

  • Default: false

Examples

Invalid

# Invalid Table Style

| Character | Meaning |
| --------- | ------- |
|Y | Yes|
| N | No |

Valid

# Valid Table Style

| Character | Meaning |
| --- | --- |
| Y | Yes |
| N | No |