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:

MD060:
  enabled: false  # Default: opt-in for conservative adoption
  style: "aligned"  # Can be "aligned", "compact", or "none"
  max_width: 120  # Optional: auto-compact for wide tables

Style Options

• aligned: Columns are padded with spaces for visual alignment (default)
• compact: No padding, minimal spacing
• none: Disable formatting checks

Max Width

When max_width is set (default: 120), tables wider than this limit will automatically use compact formatting to prevent excessive line lengths.

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 Emoji Sequences: Tables containing Zero-Width Joiner (ZWJ) emoji sequences (e.g., 👨‍👩‍👧‍👦, 👩‍💻) are automatically skipped. These complex emoji have inconsistent display widths across different terminals and fonts, making accurate alignment impossible. The rule will preserve 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) -> 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 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 from_config(config: &Config) -> Box<dyn Rule>

where Self: Sized,

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

fn check_with_ast( &self, ctx: &LintContext<'_>, _ast: &MarkdownAst, ) -> LintResult

AST-based check method for rules that can benefit from shared AST parsing By default, calls the regular check method if not overridden

fn category(&self) -> RuleCategory

Get the category of this rule for selective processing

fn as_maybe_ast(&self) -> Option<&dyn MaybeAst>

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 fix_capability(&self) -> FixCapability

Declares the fix capability of this rule