Struct MD060TableFormat 

pub struct MD060TableFormat { /* private fields */ }

Rule MD060: Table Column Alignment

See docs/md060.md for full documentation, configuration, and examples.

This rule enforces consistent column alignment in Markdown tables for improved readability in source form. When enabled, it ensures table columns are properly aligned with appropriate padding.

Purpose

• Readability: Aligned tables are significantly easier to read in source form
• Maintainability: Properly formatted tables are easier to edit and review
• Consistency: Ensures uniform table formatting throughout documents
• Developer Experience: Makes working with tables in plain text more pleasant

Configuration Options

The rule supports the following configuration options:

[MD013]
line-length = 100  # MD060 inherits this by default

[MD060]
enabled = false      # Default: opt-in for conservative adoption
style = "aligned"    # Can be "aligned", "compact", "tight", or "any"
max-width = 0        # Default: inherit from MD013's line-length

Style Options

• aligned: Columns are padded with spaces for visual alignment (default)
• compact: Minimal spacing with single spaces
• tight: No spacing, pipes directly adjacent to content
• any: Preserve existing formatting style

Max Width (auto-compact threshold)

Controls when tables automatically switch from aligned to compact formatting:

• max-width = 0 (default): Smart inheritance from MD013
• max-width = N: Explicit threshold, independent of MD013

When max-width = 0:

• If MD013 is disabled → unlimited (no auto-compact)
• If MD013.tables = false → unlimited (no auto-compact)
• If MD013.line_length = 0 → unlimited (no auto-compact)
• Otherwise → inherits MD013’s line-length

This matches the behavior of Prettier’s table formatting.

Examples

# Inherit from MD013 (recommended)
[MD013]
line-length = 100

[MD060]
style = "aligned"
max-width = 0  # Tables exceeding 100 chars will be compacted

# Explicit threshold
[MD060]
style = "aligned"
max-width = 120  # Independent of MD013

Examples

Aligned Style (Good)

| Name  | Age | City      |
|-------|-----|-----------|
| Alice | 30  | Seattle   |
| Bob   | 25  | Portland  |

Unaligned (Bad)

| Name | Age | City |
|---|---|---|
| Alice | 30 | Seattle |
| Bob | 25 | Portland |

Unicode Support

This rule properly handles:

• CJK Characters: Chinese, Japanese, Korean characters are correctly measured as double-width
• Basic Emoji: Most emoji are handled correctly
• Inline Code: Pipes in inline code blocks are properly masked

Known Limitations

Complex Unicode Sequences: Tables containing certain Unicode characters are automatically skipped to prevent alignment corruption. These include:

• Zero-Width Joiner (ZWJ) emoji: 👨‍👩‍👧‍👦, 👩‍💻
• Zero-Width Space (ZWS): Invisible word break opportunities
• Zero-Width Non-Joiner (ZWNJ): Ligature prevention marks
• Word Joiner (WJ): Non-breaking invisible characters

These characters have inconsistent or zero display widths across terminals and fonts, making accurate alignment impossible. The rule preserves these tables as-is rather than risk corrupting them.

This is an honest limitation of terminal display technology, similar to what other tools like markdownlint experience.

Fix Behavior

When applying automatic fixes, this rule:

• Calculates proper display width for each column using Unicode width measurements
• Pads cells with trailing spaces to align columns
• Preserves cell content exactly (only spacing is modified)
• Respects alignment indicators in delimiter rows (:---, :---:, ---:)
• Automatically switches to compact mode for tables exceeding max_width
• Skips tables with ZWJ emoji to prevent corruption

Implementations

impl MD060TableFormat

pub fn new(enabled: bool, style: String) -> Self

pub fn from_config_struct( config: MD060Config, md013_config: MD013Config, md013_disabled: bool, ) -> Self

Trait Implementations

impl Clone for MD060TableFormat

fn clone(&self) -> MD060TableFormat

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MD060TableFormat

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MD060TableFormat

fn default() -> MD060TableFormat

Returns the “default value” for a type.

impl Rule for MD060TableFormat

fn name(&self) -> &'static str

fn description(&self) -> &'static str

fn category(&self) -> RuleCategory

Get the category of this rule for selective processing

fn should_skip(&self, ctx: &LintContext<'_>) -> bool

Check if this rule should quickly skip processing based on content

fn check(&self, ctx: &LintContext<'_>) -> LintResult

fn fix(&self, ctx: &LintContext<'_>) -> Result<String, LintError>

fn as_any(&self) -> &dyn Any

fn default_config_section(&self) -> Option<(String, Value)>

Returns the rule name and default config table if the rule has config. If a rule implements this, it MUST be defined on the impl Rule for ... block, not just the inherent impl.

fn config_schema(&self) -> Option<(String, Value)>

Returns the rule name and every config key the rule accepts, for validation.

fn from_config(config: &Config) -> Box<dyn Rule>

where Self: Sized,

Factory: create a rule from config (if present), or use defaults.

fn skippable_by_category(&self) -> bool

Whether the content-category prefilter may skip this rule.

fn config_aliases(&self) -> Option<HashMap<String, String>>

Returns config key aliases for this rule This allows rules to accept alternative config key names for backwards compatibility

fn polymorphic_config_keys(&self) -> &'static [&'static str]

Returns the list of config keys whose deserializer accepts more than one TOML type (e.g. either a scalar or a list). The schema is built from a serialized default that can only encode one variant, so the validator would reject the alternative form. The registry replaces the schema entry for each listed key with a polymorphic sentinel so type checking is skipped while the key name is still validated. The registry rewrites Rule::config_schema, so default_config_section() keeps returning the clean user-facing default.

fn fix_capability(&self) -> FixCapability

Declares the fix capability of this rule

fn cross_file_scope(&self) -> CrossFileScope

Declares cross-file analysis requirements for this rule

fn contribute_to_index( &self, _ctx: &LintContext<'_>, _file_index: &mut FileIndex, )

Contribute data to the workspace index during linting

fn cross_file_check( &self, _file_path: &Path, _file_index: &FileIndex, _workspace_index: &WorkspaceIndex, ) -> LintResult

Perform cross-file validation after all files have been linted

fn observes_suppressions(&self) -> bool

Whether this rule reports on the inline comments that suppressed warnings

fn check_suppressions( &self, _ctx: &LintContext<'_>, _report: &SuppressionReport, ) -> LintResult

Report on a document’s inline disable comments